How to Install Monica CRM on Ubuntu with Nginx

Install Nginx

Nginx acts as the web server that delivers Monica CRM to your browser.

Grab the detailed setup steps from the guide on how to install Nginx on Ubuntu Linux before moving forward.

Install MariaDB

Monica CRM stores your data in a database, and MariaDB is the recommended database choice for the CRM. Install MariaDB on Ubuntu using the sudo apt install mariadb-server command.

sudo apt update
sudo apt install mariadb-server

Find additional database help here How to install MariaDB on Ubuntu Linux.

Install PHP-FPM

PHP-FPM processes the dynamic code that Monica CRM relies on. Follow the guide on how to install PHP or PHP-FPM on Ubuntu Linux to get the right packages installed.

Install Composer

Next, install Composer, a vital tool for managing Monica CRM's software packages. This step ensures all necessary components are ready for your Monica CRM installation.

Composer manages the underlying software packages that Monica CRM requires to function properly.

Your Monica CRM installation on Ubuntu needs a dedicated database and user. A new database and a specific user will be created for Monica CRM's data storage. This pairing ensures Monica CRM has a secure, separate location for all its important information.

sudo mysql -u root -p

CREATE DATABASE monicadb;
CREATE USER 'monicadbuser'@'localhost';
ALTER USER 'monicadbuser'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL ON monicadb.* TO 'monicadbuser'@'localhost';
FLUSH PRIVILEGES;
exit

Install Monica

Finally, install Monica CRM on your Ubuntu server by downloading the latest version and configuring it. This step brings Monica CRM to your system, ready for setup.

sudo -u www-data composer install --no-interaction --no-dev
sudo -u www-data yarn install
sudo -u www-data yarn run production

sudo -u www-data php artisan key:generate
sudo -u www-data php artisan setup:production -v

Configure Nginx

Create a server block file in /etc/nginx/sites-available/monicacrm. Ensure the fastcgi_pass directive points to the correct PHP socket version:

fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;

Enable the site, test the configuration, and restart Nginx to apply the changes.

Access Monica Portal

Navigate to your domain in your web browser. You can now register your account and begin using your CRM. For security, consider setting up SSL using Let's Encrypt How to install and use Let's Encrypt SSL with Nginx on Ubuntu Linux.

[signed-by=/usr/share/keyrings/yarnkey.gpg]