How to Install Bolt CMS with Nginx on Ubuntu 24.04

Setting up Bolt CMS with Nginx on Ubuntu 24.04 is a practical way to create a lightweight, flexible, and high-performance content management system for your website. Bolt CMS is known for its simplicity and modern architecture, making it ideal for developers and content creators alike. This guide walks you through each step to get Bolt CMS up and running smoothly on your Ubuntu server with Nginx as the web server. Before starting, ensure your server has a fresh Ubuntu 24.04 installation and access to a terminal with root or sudo privileges.

What You’ll Need

Ubuntu 24.04 server installed and accessible via SSH
Root or sudo privileges on the server
Domain name pointed to your server’s IP address (optional but recommended)
Basic familiarity with Linux command line

Step-by-Step

Update your system packages to ensure all software is current:
```
sudo apt update && sudo apt upgrade -y
```

Install necessary dependencies such as PHP, Composer, Nginx, and MariaDB (or MySQL):

sudo apt install nginx php php-fpm php-cli php-mbstring php-zip php-xml php-mysql php-curl php-gd php-bcmath php-zip php-intl php-mbstring unzip git mariadb-server -y

Secure your MariaDB installation:
```
sudo mysql_secure_installation
```
Follow the prompts to set a root password and secure your database server.

Create a dedicated database and user for Bolt CMS:

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

Download the latest Bolt CMS package from the official website or GitHub repository:
```
cd /var/www
sudo git clone https://github.com/bolt/bolt.git bolt-cms
```

Set proper permissions for the Bolt CMS directory:

sudo chown -R www-data:www-data /var/www/bolt-cms
sudo chmod -R 755 /var/www/bolt-cms

Configure environment variables for Bolt by copying the example environment file:
```
cd /var/www/bolt-cms
sudo cp .env.example .env
```
Edit the `.env` file with your database credentials:
```
sudo nano .env
```

Install dependencies with Composer:

cd /var/www/bolt-cms
sudo apt install composer
composer install --no-dev --optimize-autoloader

Generate application key and set up the database schema:
```
php bin/console bolt:install
```

Create an Nginx server block for your domain:

sudo nano /etc/nginx/sites-available/bolt.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/bolt-cms/public;
    index index.php;

    location / {
        try_files $uri /index.php$is_args$args;
    }

    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;
    }
}

Save and enable the site:

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

Secure your site with SSL using Let’s Encrypt (optional but recommended):

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

Finalize installation by visiting your domain in a web browser and completing any remaining setup prompts.

Common Mistakes

Not updating system packages before starting, leading to compatibility issues.
Incorrect database credentials in the `.env` file, causing connection errors.
Forgetting to set proper permissions on the Bolt directory, resulting in server errors.
Failing to reload or restart Nginx after making configuration changes.
Not securing the site with SSL, which could leave data vulnerable.
Using incompatible PHP versions—ensure PHP 8.1 is installed and configured correctly.

Tips

Always back up your database and website files before making major changes.
Use strong, unique passwords for your database and admin accounts.
Regularly update Bolt CMS and server software to patch security vulnerabilities.
Configure automatic renewal for SSL certificates to maintain secure connections.
Monitor server logs for errors and resolve issues promptly.
Consider setting up a firewall (e.g., UFW) to restrict access to necessary services only.

Troubleshooting

Website not loading or showing a 502 Bad Gateway error: Check PHP-FPM status with `sudo systemctl status php8.1-fpm`. Restart it if necessary: `sudo systemctl restart php8.1-fpm`.
Database connection errors: Verify credentials in `.env`, ensure the database server is running, and check user privileges.
Nginx configuration issues: Test configuration syntax with `sudo nginx -t`. Reload Nginx after changes: `sudo systemctl reload nginx`.
SSL not working: Confirm Certbot certificates are valid with `sudo certbot certificates`. Renew if expired.
Permissions errors: Ensure web server user (`www-data`) owns the Bolt directory and files.

Frequently Asked Questions

Can I install Bolt CMS without a domain name?: Yes, you can access Bolt locally via your server’s IP address, but using a domain name is recommended for production.
Is Nginx better than Apache for Bolt CMS?: Nginx generally offers better performance and lower resource usage, making it a popular choice for serving Bolt CMS.
Do I need to secure my site with SSL?: Yes, securing your site with SSL encrypts data transmission and is essential for protecting user information and SEO.
How often should I update Bolt CMS?: Regularly check for updates and apply them promptly to benefit from security patches and new features.
Can I run multiple sites on the same server with Bolt CMS?: Yes, by creating separate Nginx server blocks and databases for each site, you can host multiple Bolt installations.
What are the system requirements for running Bolt CMS?: At least 2GB RAM, PHP 8.1, and a compatible database like MariaDB or MySQL are recommended for optimal performance.

This comprehensive guide should help you successfully set up Bolt CMS with Nginx on Ubuntu 24.04, giving you a solid foundation for your website or project. Remember to keep your system updated, secure your server, and regularly back up your data to ensure smooth operation and security.

How to Install Bolt CMS with Nginx on Ubuntu 24.04

How to Install Bolt CMS with Nginx on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Related