How to Install Dolibarr with Nginx on Ubuntu 24.04

Setting up Dolibarr on Ubuntu 24.04 with Nginx allows you to create a lightweight, efficient, and modern enterprise resource planning (ERP) and customer relationship management (CRM) system. Nginx offers high performance and low resource consumption, making it an excellent choice for hosting Dolibarr. This guide walks you through the entire installation process, ensuring your Dolibarr instance runs smoothly on your Ubuntu server. Before starting, ensure you have a fresh Ubuntu 24.04 server with root or sudo privileges, a domain name pointing to your server’s IP, and basic familiarity with Linux commands.

What You’ll Need

• Ubuntu 24.04 server with sudo privileges
• Domain name configured to point to your server’s IP address
• Basic knowledge of Linux command line
• Access to a terminal or SSH client

Step-by-Step

1. Update Your System
   Start by updating your package list and upgrading existing packages to ensure compatibility.

   sudo apt update && sudo apt upgrade -y

2. Install Required Dependencies
   Install PHP, MariaDB (MySQL alternative), Nginx, and other necessary packages.

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

3. Secure MariaDB
   Run the security script to set root password and remove insecure defaults.

   sudo mysql_secure_installation

   Follow prompts to set a strong root password and secure your database server.

4. Create a Database and User for Dolibarr
   Log into MariaDB and set up a dedicated database.

   sudo mysql -u root -p

   Then, execute:

   CREATE DATABASE dolibarrdb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   CREATE USER 'dolibarruser'@'localhost' IDENTIFIED BY 'your_password_here';
   GRANT ALL PRIVILEGES ON dolibarrdb.* TO 'dolibarruser'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

5. Download Dolibarr
   Download the latest stable release from the official site.

   wget https://sourceforge.net/projects/dolibarr/files/latest/download -O dolibarr.zip

   Extract it and move to web directory.

   unzip dolibarr.zip -d /var/www/html/dolibarr

6. Set Permissions
   Adjust ownership and permissions for web access.

   sudo chown -R www-data:www-data /var/www/html/dolibarr
   sudo chmod -R 755 /var/www/html/dolibarr

7. Configure Nginx
   Create a new server block for Dolibarr.

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

   Add the following configuration, replacing with your domain:

   server {
       listen 80;
       server_name ;
   
       root /var/www/html/dolibarr;
       index index.php index.html index.htm;
   
       location / {
           try_files $uri $uri/ /index.php?$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;
       }
   }
   

   Enable the site and test configuration.

   sudo ln -s /etc/nginx/sites-available/dolibarr /etc/nginx/sites-enabled/
   sudo nginx -t
   sudo systemctl reload nginx

8. Complete Dolibarr Setup
   Visit http:// in your browser. Follow the on-screen instructions to connect to the database and configure Dolibarr. Make sure to select PHP 8+ and fill in your database details.

Common Mistakes

• Not updating the system before starting installation, leading to package conflicts.
• Forgetting to set correct permissions on Dolibarr files, causing access issues.
• Misconfiguring the Nginx server block, resulting in site not loading properly.
• Using incorrect PHP version paths in the Nginx configuration.
• Neglecting to secure MariaDB or leaving default insecure settings.

Tips

• Use SSL/TLS for secure connections—consider setting up Let’s Encrypt for free SSL certificates.
• Regularly update your system and Dolibarr to keep security patches current.
• Back up your database and Dolibarr files periodically.
• Monitor your server logs for errors or suspicious activity.
• Configure firewall rules to restrict unnecessary access.

Troubleshooting

If Dolibarr does not load correctly or you encounter errors:

• Check Nginx syntax with sudo nginx -t. If errors are found, fix the configuration files accordingly.
• Ensure PHP-FPM is running: sudo systemctl status php8.1-fpm. Restart if necessary: sudo systemctl restart php8.1-fpm.
• Review Nginx error logs at /var/log/nginx/error.log for clues.
• Verify database connection details in the Dolibarr setup wizard.
• Clear browser cache or try accessing from incognito mode.

Frequently Asked Questions

1. Can I install Dolibarr without a domain name?

Yes, you can access Dolibarr via your server’s IP address, but using a domain name is recommended for easier access and SSL setup.

2. How do I enable HTTPS for my Dolibarr site?

Install Certbot and obtain a free SSL certificate from Let’s Encrypt. Configure your Nginx server block to use SSL certificates for secure connections.

3. Is it safe to run Dolibarr on a public server?

Yes, if you follow security best practices such as setting strong passwords, enabling SSL, keeping software updated, and configuring firewalls.

4. Can I upgrade Dolibarr later?

Yes, Dolibarr provides upgrade instructions. Always back up your data before performing upgrades.

5. How do I backup my Dolibarr installation?

Backup your database using mysqldump and copy Dolibarr files regularly to a safe location.

6. What are the recommended server specifications?

For small to medium use, a server with 2GB RAM, 2 CPU cores, and sufficient disk space is usually adequate. Adjust based on expected load.

Following this comprehensive guide ensures a smooth installation of Dolibarr with Nginx on Ubuntu 24.04, providing a robust foundation for your ERP and CRM needs. Regular maintenance, security practices, and backups will keep your system reliable and secure over time.

Related

• How To Hide Windows Updates in Windows 10 Effectively
• How to Hide Windows Terminal in Notification Area
• How To Hide Wi-Fi Networks (SSIDs) in Windows 10 Easily