How to Install October CMS with Nginx on Ubuntu 24.04

Setting up October CMS on an Ubuntu 24.04 server with Nginx provides a powerful, flexible platform for building and managing content-driven websites. This guide walks you through the entire installation process, ensuring your server is configured correctly for optimal performance and security. Before starting, ensure you have a fresh Ubuntu 24.04 server with root or sudo privileges, a domain name pointed to your server’s IP, and basic familiarity with Linux command line operations.

What You’ll Need

Ubuntu 24.04 server with root or sudo access
Domain name pointed to your server’s IP address
Basic knowledge of Linux commands
SSH client (like PuTTY or terminal)
Firewall configured to allow HTTP (80) and HTTPS (443)

Step-by-Step

Update your system packages: Begin by updating your server to ensure all packages are current.
```
sudo apt update && sudo apt upgrade -y
```

Install necessary dependencies: Install PHP, MySQL (or MariaDB), Nginx, and other required packages.

sudo apt install nginx php php-fpm php-mysql php-xml php-mbstring php-curl php-zip php-gd unzip mysql-server -y

Secure your MySQL installation: Run the security script and set a root password.
```
sudo mysql_secure_installation
```

Create a database for October CMS: Log into MySQL and create a dedicated database and user.

sudo mysql -u root -p
CREATE DATABASE october_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'october_user'@'localhost' IDENTIFIED BY 'your_password_here';
GRANT ALL PRIVILEGES ON october_db.* TO 'october_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download October CMS: Navigate to your web root directory and download the latest version.

cd /var/www
sudo wget https://github.com/octobercms/october/archive/refs/heads/develop.zip
sudo unzip develop.zip -d october
sudo chown -R www-data:www-data october

Configure Nginx server block: Create a new configuration file for your site.

sudo nano /etc/nginx/sites-available/october.conf

Insert the following configuration, replacing ‘yourdomain.com’ with your actual domain:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

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

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

    location = /favicon.ico {
        access_log off; log_not_found off;
    }

    location = /robots.txt {
        access_log off; log_not_found off;
    }

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

    location ~ /\.ht {
        deny all;
    }
}

Enable the site and test Nginx configuration:

sudo ln -s /etc/nginx/sites-available/october.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Configure PHP-FPM: Ensure PHP-FPM is running and enabled.

sudo systemctl enable php8.1-fpm
sudo systemctl start php8.1-fpm

Finalize October CMS setup: Visit your domain in a browser. You will see October CMS setup wizard.
Follow the prompts to connect to your database, set admin credentials, and configure your site.

Secure your site with SSL: Use Let’s Encrypt to obtain a free SSL certificate.

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

Common Mistakes

Not updating system packages before starting installation, leading to compatibility issues.
Wrong permissions on the October CMS files, causing server errors.
Misconfigured database credentials, resulting in connection errors during setup.
Forgetting to enable and restart PHP-FPM or Nginx after configuration changes.
Not securing the server with SSL, leaving data vulnerable.

Tips

Always back up your server before major changes.
Use strong, unique passwords for database and admin accounts.
Configure automatic renewal for SSL certificates with Certbot.
Optimize PHP and Nginx settings for better performance.
Regularly update October CMS and server packages to patch security issues.

Troubleshooting

Site not loading or showing errors: Check Nginx error logs at /var/log/nginx/error.log and PHP-FPM logs. Confirm your server block is enabled and correctly configured.
Database connection errors: Verify your database credentials in the October CMS setup and ensure the MySQL service is running.
Permissions issues: Ensure the web server user (www-data) owns the October CMS files: sudo chown -R www-data:www-data /var/www/october.
SSL certificate issues: Run sudo certbot renew periodically or check Certbot logs for errors.

Frequently Asked Questions

Can I install October CMS without root access?: It’s recommended to have root or sudo privileges for full control, but you can install in user directories if your environment allows.
Is Nginx suitable for October CMS?: Yes, Nginx is a popular, high-performance choice for hosting October CMS, especially when configured correctly.
How do I upgrade October CMS later?: Use the built-in update commands or manually replace the core files, ensuring backups are taken beforehand.
What about security best practices?: Keep software updated, use strong passwords, secure your database, enable SSL, and limit server access.
Can I run October CMS on a subdomain or subdirectory?: Yes, by configuring your Nginx server block accordingly, you can host October CMS on subdomains or subdirectories.

This comprehensive guide aims to help you successfully deploy October CMS on your Ubuntu 24.04 server with Nginx, providing a reliable foundation for your content management needs, with tips and troubleshooting to ensure smooth operation and security.

How to Install October CMS with Nginx on Ubuntu 24.04

How to Install October CMS with Nginx on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Related