How to Install Shopware with Nginx on Ubuntu 24.04

Setting up Shopware on Ubuntu 24.04 with Nginx allows you to create a fast, scalable, and reliable eCommerce platform tailored to your needs. This guide walks you through each step, from preparing your server to configuring the web server and installing Shopware. Before starting, ensure your server has a clean Ubuntu 24.04 installation with root or sudo access. You will also need a domain name pointed to your server’s IP address, as well as basic familiarity with Linux command-line operations.

What You’ll Need

Ubuntu 24.04 server with root or sudo access
Domain name configured to point to your server’s IP
Basic knowledge of Linux terminal commands
SSL certificate (recommended for production)
At least 8 GB RAM and 50 GB storage (recommended for Shopware)

Step-by-Step

Update Your Server: Begin by updating your system packages to ensure all software is current.
```
sudo apt update && sudo apt upgrade -y
```

Install Required Dependencies: Install PHP, Composer, MariaDB (or MySQL), and other essentials.

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

Secure MariaDB: Run the security script and set a root password.
```
sudo mysql_secure_installation
```

Create a Database and User for Shopware: Log into MariaDB and set up your database.

sudo mysql -u root -p
CREATE DATABASE shopware;
CREATE USER 'shopwareuser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON shopware.* TO 'shopwareuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download and Install Composer: Composer is essential for managing PHP dependencies.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

Download Shopware: Obtain the latest Shopware version from their official repository.

cd /var/www
sudo git clone --branch 6.5 https://github.com/shopware/development.git shopware

Set Permissions: Ensure the web server can access the files.

sudo chown -R www-data:www-data /var/www/shopware
sudo chmod -R 755 /var/www/shopware

Configure PHP-FPM: Adjust PHP settings if necessary, typically found in /etc/php/8.4/fpm/php.ini.
```
sudo nano /etc/php/8.4/fpm/php.ini
```

Configure Nginx: Create a new server block for your domain.

sudo nano /etc/nginx/sites-available/shopware

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/shopware;

    index index.php index.html index.htm;

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

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

    location ~ \.ht {
        deny all;
    }
}

# Enable the site
sudo ln -s /etc/nginx/sites-available/shopware /etc/nginx/sites-enabled/

# Test configuration and reload
sudo nginx -t
sudo systemctl reload nginx

Configure SSL (Optional but Recommended): Use Let’s Encrypt to secure your site.

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

Complete Shopware Installation: Navigate to your domain in a browser and follow the on-screen installation wizard, providing database details and admin credentials.

Common Mistakes

Not updating server packages before starting, leading to compatibility issues.
Forgetting to set correct permissions on the Shopware directory, causing server errors.
Misconfiguring the Nginx server block, resulting in 404 or 502 errors.
Not securing your server with SSL, which is critical for eCommerce sites.
Using default or weak passwords for database or admin accounts.
Overlooking PHP configuration requirements for Shopware, such as memory limits.

Tips

Always back up your server and database before major changes.
Use strong, unique passwords for database and admin accounts.
Regularly update your server and Shopware installation to patch security vulnerabilities.
Configure automatic SSL renewal with Certbot to keep your site secure.
Monitor server logs for errors during installation and operation.
Optimize PHP and Nginx settings based on your server’s resources for better performance.

Troubleshooting

404 Not Found on Shopware Pages: Check your Nginx configuration and ensure the root path is correct. Verify that the rewrite rules are properly set to route requests to index.php.
502 Bad Gateway Errors: Ensure PHP-FPM is running and the socket path is correct. Restart PHP-FPM if needed:
```
sudo systemctl restart php8.4-fpm
```
Database Connection Errors: Double-check your database credentials in the Shopware configuration and ensure the database server is running.
SSL Not Working: Verify your Certbot certificate renewal and configuration. Check for errors in Nginx logs.
Performance Issues: Review server resource usage, optimize PHP memory limits, and consider caching strategies.

Frequently Asked Questions

Can I install Shopware without SSL?: Yes, but it is strongly recommended to use SSL for security, especially on eCommerce sites handling sensitive data.
How do I upgrade Shopware after installation?: Use the Shopware admin panel or CLI commands to update to newer versions, following their official upgrade guides.
What are the recommended server specs for Shopware?: At least 8 GB RAM, a modern CPU, and 50 GB storage are recommended for smooth operation, especially with multiple visitors.
How do I secure my Shopware server?: Use strong passwords, keep software updated, enable SSL, and configure firewalls to restrict access.
Can I run Shopware on a shared hosting environment?: Shopware requires a dedicated server or VPS with root access for optimal performance and configuration flexibility.
What should I do if I encounter installation errors?: Check server logs, verify dependencies, ensure correct permissions, and follow the official Shopware installation documentation.

Following this comprehensive guide will help you successfully install and run Shopware on Ubuntu 24.04 with Nginx. Proper configuration and security practices ensure your eCommerce platform remains reliable and secure, providing a solid foundation for your online store.

How to Install Shopware with Nginx on Ubuntu 24.04

How to Install Shopware with Nginx on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Related