How to Install Dolibarr with Apache on Ubuntu 24.04

Dolibarr is a powerful open-source ERP and CRM platform that helps small and medium-sized businesses manage their operations efficiently. Installing Dolibarr on an Ubuntu 24.04 server with Apache allows you to host your own business management system, customize it to your needs, and ensure data privacy. This guide provides clear, step-by-step instructions to get Dolibarr up and running on your Ubuntu 24.04 server, assuming you have basic Linux command line knowledge. Before you start, ensure your server is updated, and you have root or sudo privileges.

What You’ll Need

Ubuntu 24.04 server installed and configured
Root or sudo user access
Basic knowledge of Linux command line
Internet connection for downloading packages

Step-by-Step

Update Your System

Start by updating your package list and upgrading existing packages to ensure your system is current. Run:

sudo apt update && sudo apt upgrade -y

Install Apache, MariaDB, and PHP

Dolibarr requires a web server, database, and PHP. Install them with:

sudo apt install apache2 mariadb-server libapache2-mod-php php php-mysql php-xml php-curl php-gd php-mbstring php-zip php-bcmath -y

Secure MariaDB

Run the security script to set root password and remove insecure defaults:

sudo mysql_secure_installation

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

Create a Database and User for Dolibarr

Log into MariaDB:

sudo mysql -u root -p

Then execute:

CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON dolibarr_db.* TO 'dolibarr_user'@'localhost' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;
EXIT;

Replace ‘your_password’ with a secure password.

Download Dolibarr

Navigate to your web directory and download the latest Dolibarr package:

cd /var/www/html
sudo wget https://github.com/Dolibarr/dolibarr/releases/latest/download/dolibarr-*.zip

Extract the archive:

sudo apt install unzip -y
sudo unzip dolibarr-*.zip -d dolibarr

Set Permissions

Adjust ownership and permissions:

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

Configure Apache Virtual Host

Create a new configuration file:

sudo nano /etc/apache2/sites-available/dolibarr.conf

Add the following content:

<VirtualHost *:80>
    ServerAdmin admin@yourdomain.com
    ServerName yourdomain.com
    DocumentRoot /var/www/html/dolibarr
    ErrorLog ${APACHE_LOG_DIR}/dolibarr_error.log
    CustomLog ${APACHE_LOG_DIR}/dolibarr_access.log combined
    <Directory /var/www/html/dolibarr>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Enable the site and rewrite module:

sudo a2ensite dolibarr.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Complete the Installation via Web Browser

Open your browser and navigate to http://yourdomain.com or http://server-ip. Follow the Dolibarr web installer instructions, provide database details, and set up your administrator account. Once finished, delete or secure the install directory as prompted.

Common Mistakes

Not securing MariaDB after installation, leaving it vulnerable to attacks.
Incorrect permissions on Dolibarr files, causing server errors or inability to access files.
Forgetting to enable Apache rewrite module, which can prevent URL rewriting and proper operation.
Using incorrect database credentials during setup, leading to connection errors.
Not deleting the installation files after setup, which can pose a security risk.

Tips

Use strong, unique passwords for your database user and MariaDB root account.
Set up a domain name with DNS records pointing to your server IP for easier access.
Regularly update your system and Dolibarr to patch security vulnerabilities.
Configure SSL/TLS with Let’s Encrypt for secure HTTPS access.
Back up your Dolibarr database regularly to prevent data loss.

Troubleshooting

If you encounter issues during installation or after:

Cannot access Dolibarr web interface: Check Apache error logs with sudo tail -f /var/log/apache2/error.log and ensure the virtual host is correctly configured.
Database connection errors: Verify database credentials in the Dolibarr setup and ensure the database user has proper privileges.
Permissions problems: Ensure files are owned by www-data and permissions are set correctly as detailed above.
PHP errors or blank pages: Check PHP error logs and ensure all required PHP modules are installed and enabled.
Security warnings during setup: Delete the install directory as soon as setup completes to prevent unauthorized reinstallation.

Frequently Asked Questions

Can I install Dolibarr on a different web server?: Yes, but this guide focuses on Apache. For other servers like Nginx, configurations differ.
Is it safe to run Dolibarr on a public server?: With proper security measures like HTTPS, strong passwords, and regular updates, it can be safe.
How often should I update Dolibarr?: Regularly check for updates and apply them to benefit from security patches and new features.
Can I customize Dolibarr after installation?: Yes, Dolibarr is highly customizable with modules and themes. Always back up before making major changes.
What if I encounter database errors during setup?: Verify your database credentials, ensure the database exists, and that the user has proper privileges.

Following these steps carefully will enable you to successfully install and run Dolibarr ERP/CRM on your Ubuntu 24.04 server with Apache, providing your business with a powerful management tool hosted on your own infrastructure.

How to Install Dolibarr with Apache on Ubuntu 24.04

How to Install Dolibarr with Apache on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Related