Dolibarr is an open source enterprise resource planning (ERP) and customer relationship management (CRM) for Business. Dolibarr source code is hosted on GitHub. This guide will show you how to install Dolibarr ERP and CRM on a fresh Fedora 28 Vultr instance.
Requirements
- MariaDB version 5.0.3 or greater
- PHP version 5.3.0 or greater. This article will use version 7.2
- Nginx
Before you begin
Check the Fedora version.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Create a new non-root
user account with sudo
access and switch to it.
useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe
NOTE: Replace johndoe
with your username.
Ensure that your system is up to date.
sudo dnf check-upgrade || sudo dnf upgrade -y
Set up the timezone.
sudo timedatectl set-timezone 'Region/City'
For simplicity, disable SELinux and Firewall.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
Step 1 - Install PHP
Install PHP 7.2 and necessary extensions.
sudo dnf install -y php-cli php-fpm php-xml php-zip php-sqlite3 php-gd php-mbstring php-mcrypt php-soap php-mysqlnd php-pgsql php-curl php-json
Check the version.
php --version
# PHP 7.2.6 (cli) (built: May 22 2018 16:22:08) ( NTS )
Start and enable php-fpm.service
.
sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service
Step 2 - Install MariaDB and create a database
Install MariaDB.
sudo dnf install -y mariadb-server
Check the version.
mysql --version
# mysql Ver 15.1 Distrib 10.2.14-MariaDB, for Linux (x86_64) using readline 5.1
Start and enable MariaDB.
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
Run the mysql_secure_installation
script to improve the security of your MariaDB installation.
sudo mysql_secure_installation
Log into MariaDB as the root user.
mysql -u root -p
# Enter password:
Create a new MariaDB database and database user, and remember the credentials.
mysql> CREATE DATABASE db_name CHARACTER SET utf8;
mysql> GRANT ALL ON db_name.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;
mysql> quit
NOTE: Replace db_name
and username
with appropriate names for your setup. Replace password
with a strong password.
Install Nginx.
sudo dnf install -y nginx
Check the version.
sudo nginx -v
# nginx version: nginx/1.12.1
Start and enable the Nginx service.
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
Configure Nginx.
sudo vim /etc/nginx/conf.d/dolibarr.conf
Populate the file with the following configuration.
server {
listen [::]:80;
listen 80;
server_name example.com; # Check this
root /var/www/dolibarr/htdocs; # Check this
index index.php index.html index.htm;
charset utf-8;
location / {
try_files $uri $uri/ /index.php;
}
location ~ [^/]\.php(/|$) {
try_files $uri =404;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_read_timeout 600;
include fastcgi_params;
fastcgi_pass unix:/run/php-fpm/www.sock;
}
}
Test the configuration.
sudo nginx -t
Reload Nginx.
sudo systemctl reload nginx.service
Step 4 - Install Composer
To install Dolibarr, we will need to install Composer.
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Check the Composer version.
composer --version
# Composer version 1.6.5 2018-05-04 11:44:59
Step 5 - Install Dolibarr
Create a document root directory.
sudo mkdir -p /var/www/dolibarr
Change ownership of the /var/www/dolibarr
directory to johndoe
.
sudo chown -R johndoe:johndoe /var/www/dolibarr
Download the latest stable release of Dolibarr from the command line.
cd /var/www/dolibarr
composer create-project dolibarr/dolibarr .
Change ownership of the /var/www/dolibarr
directory to nginx
.
sudo chown -R nginx:nginx /var/www/dolibarr
Create a /var/lib/php/session
directory and change ownership to the nginx
user.
sudo mkdir -p /var/lib/php/session
sudo chown -R nginx:nginx /var/lib/php/
Run sudo vim /etc/php-fpm.d/www.conf
and set the user and group to nginx
. Initially, it will be set to the user and group apache
.
sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx
Restart php-fpm.service
.
sudo systemctl restart php-fpm.service
Using your preferred web browser, open your http://example.com/install/
page and follow the Dolibarr installer. Replace example.com
with your domain name, or IP address if you don't have domain name. After following the installation wizard, you will have Dolibarr ERP/CRM up and running.