Mets Minor League Blog

Music theory, instruments and musicians

Mets Minor League Blog

Music theory, instruments and musicians

How to Install Drupal with Nginx on Ubuntu 24.04

By metsPosted on Posted in Sport Gear

How to Install Drupal with Nginx on Ubuntu 24.04

Setting up Drupal with Nginx on Ubuntu 24.04 provides a lightweight, high-performance environment for your content management system. This guide walks you through installing and configuring everything step-by-step, ensuring your Drupal site runs smoothly on the latest Ubuntu server. Before starting, make sure you have a clean Ubuntu 24.04 server, root or sudo access, and a basic understanding of terminal commands. You will also need a domain name pointed to your server’s IP address, though this isn’t strictly necessary for local testing.

What You’ll Need

  • Ubuntu 24.04 server installed and updated
  • Root or sudo privileges
  • Domain name (optional but recommended)
  • Basic familiarity with Linux command line
  • Optional: SSL certificate for HTTPS (recommended for production)

Step-by-Step

  1. Update your system packages: Open your terminal and run: 
    sudo apt update && sudo apt upgrade -y

    This ensures all your packages are current and reduces potential conflicts.

  2. Install necessary dependencies: Install PHP, Nginx, MariaDB (or MySQL), and other required packages: 
    sudo apt install nginx php php-fpm php-mysql php-xml php-gd php-curl php-zip php-mbstring mariadb-server unzip wget -y
  3. Secure your MariaDB installation: Run: 
    sudo mysql_secure_installation

    Follow the prompts to set a root password, remove anonymous users, disable root login remotely, and remove test databases.

  4. Create a Drupal database and user: Log into MariaDB: 
    sudo mariadb

    Then execute:

    CREATE DATABASE drupaldb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'drupaluser'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON drupaldb.* TO 'drupaluser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
  5. Download and extract Drupal: Get the latest Drupal release: 
    wget https://www.drupal.org/download-latest/tar.gz -O drupal.tar.gz
tar -xzf drupal.tar.gz
sudo mv drupal-* /var/www/html/drupal

    Adjust ownership:

    sudo chown -R www-data:www-data /var/www/html/drupal
  6. Configure Nginx: Create a new site configuration file: 
    sudo nano /etc/nginx/sites-available/drupal

    Paste the following, replacing your_domain.com with your domain or server IP:

    server {
    listen 80;
    server_name your_domain.com;

    root /var/www/html/drupal;
    index index.php index.html index.htm;

    location / {
        try_files $uri /index.php?$query_string;
    }

    location @rewrite {
        rewrite ^ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ \.htaccess$ {
        deny all;
    }
}

    Save and exit. Enable the site:

    sudo ln -s /etc/nginx/sites-available/drupal /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
  7. Configure PHP-FPM: Ensure PHP-FPM is running: 
    sudo systemctl start php8.2-fpm
sudo systemctl enable php8.2-fpm
  8. Complete Drupal installation via web browser: Open your browser and navigate to http://your_domain.com. Follow the on-screen instructions to select language, connect to your database, and configure your site.
  9. Secure your site with HTTPS (optional but recommended): Use Certbot to install SSL certificates: 
    sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your_domain.com

    Follow prompts to configure HTTPS and redirect all traffic securely.

Common Mistakes

  • Not updating the system before starting, leading to dependency issues.
  • Using incorrect permissions on Drupal files, causing access errors.
  • Forgetting to restart or reload Nginx and PHP-FPM after configuration changes.
  • Failing to secure the database or forgetting to set strong passwords.
  • Not configuring the site’s domain correctly in Nginx, resulting in inaccessible site.

Tips

  • Use strong, unique passwords for database and admin accounts.
  • Regularly update Drupal core and modules for security.
  • Backup your database and files before major changes or updates.
  • Configure firewall rules to allow only necessary ports (80, 443).
  • Consider setting up a staging environment before deploying live.

Troubleshooting

If your Drupal site isn’t loading or shows errors, consider these steps:

  • Check Nginx error logs: Run sudo tail -f /var/log/nginx/error.log for clues.
  • Verify PHP-FPM is running: Use sudo systemctl status php8.2-fpm.
  • Ensure database connection details are correct: Review settings.php in your Drupal files.
  • Clear Drupal cache: Use Drush or navigate to admin interface to clear cache.
  • Check file permissions: Make sure files are owned by www-data and permissions are correct.

Following these steps should resolve most common issues. If problems persist, consult Drupal community forums or server logs for further guidance.

Frequently Asked Questions

1. Can I install Drupal with Nginx on Ubuntu 24.04 without SSL?

Yes, you can run Drupal on HTTP, but for security and user trust, enabling HTTPS with SSL is highly recommended.

2. Is it necessary to disable Apache if I install Nginx?

Yes, if Apache is running, it can conflict with Nginx since both try to listen on port 80. Stop and disable Apache before proceeding.

3. How do I update Drupal once installed?

Update Drupal core and modules through the admin interface or using Drush commands. Always back up before updates.

4. Can I run multiple Drupal sites on the same server with Nginx?

Yes, by creating separate server blocks (virtual hosts) for each site with distinct domain names or subdomains.

5. What performance tips improve Drupal on Nginx?

Enable caching, use a PHP opcode cache like OPcache, optimize database, and consider using a CDN for static files.

6. How do I migrate an existing Drupal site to this setup?

Export your database, copy files, update the database connection in settings.php, and adjust your Nginx configuration as needed.

This comprehensive guide ensures you have all the necessary steps and tips to successfully deploy Drupal on Ubuntu 24.04 with Nginx, providing a solid foundation for a secure, high-performance website.

Related

How to Install Drupal with Nginx on Ubuntu 24.04
Scroll to top