How to Install vTiger CRM with Nginx on Ubuntu 24.04

Setting up vTiger CRM on an Ubuntu 24.04 server using Nginx allows you to create a powerful, lightweight, and customizable customer relationship management system. This guide walks you through the entire process—from installing necessary components to configuring vTiger with Nginx—ensuring you have a fully functional CRM tailored to your needs. Before starting, ensure you have a clean 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 (fresh installation recommended)
Root or sudo user privileges
Domain name pointing to your server’s IP
Basic knowledge of Linux command line
Firewall configured to allow HTTP (80), HTTPS (443), and SSH (22)

Step-by-Step

Update Your System
- Run sudo apt update && sudo apt upgrade -y to ensure all packages are current.

Install Necessary Dependencies

Install PHP, MariaDB (or MySQL), Nginx, and other required packages:

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

Secure Your Database Server

Run sudo mysql_secure_installation and follow prompts to set root password and remove anonymous users.
Log into MySQL: sudo mysql -u root -p

Create a database and user for vTiger:

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

Download vTiger CRM

Navigate to vTiger official website and download the latest version, or use wget:

wget https://sourceforge.net/projects/vtigercrm/files/vtiger%20CRM/9.4.0/vtigercrm9.4.0.zip/download -O vtiger.zip

Extract vTiger Files
- Create a directory for vTiger: sudo mkdir -p /var/www/vtiger
- Unzip the package: sudo unzip vtiger.zip -d /var/www/vtiger
- Set proper permissions:
```
sudo chown -R www-data:www-data /var/www/vtiger
sudo chmod -R 755 /var/www/vtiger
```

Configure Nginx

Create a new server block:

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

Insert the following configuration, replacing yourdomain.com with your actual domain:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /var/www/vtiger;

    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:

sudo ln -s /etc/nginx/sites-available/vtiger /etc/nginx/sites-enabled/

Test Nginx configuration and reload:

sudo nginx -t
sudo systemctl reload nginx

Configure PHP Settings
- Edit PHP-FPM pool configuration if needed: sudo nano /etc/php/8.1/fpm/php.ini
- Increase upload_max_filesize and post_max_size to at least 50MB:
```
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
```
- Restart PHP-FPM:
```
sudo systemctl restart php8.1-fpm
```
Complete vTiger Installation via Web
- Open your browser and navigate to http://yourdomain.com
- Follow the on-screen prompts to select language, enter database details, and configure admin credentials.
- Finish installation, then delete or secure the install directory as instructed.

Common Mistakes

Not updating system packages before starting, leading to dependency issues.
Forgetting to set correct permissions on vTiger files, causing access errors.
Incorrect database credentials during setup, resulting in connection failures.
Failing to restart PHP-FPM or Nginx after configuration changes.
Not securing the installation directory, risking security vulnerabilities.

Tips

Use a dedicated subdomain or SSL certificate for secure access.
Regularly update vTiger to the latest version for security and features.
Back up your database and files before major updates or changes.
Configure firewall rules to restrict access to sensitive ports.
Enable HTTPS using Let’s Encrypt for secure data transmission.

Troubleshooting

If vTiger isn’t loading correctly or you encounter errors, consider the following steps:

Check Nginx error logs: sudo tail -f /var/log/nginx/error.log
Verify PHP-FPM is running: sudo systemctl status php8.1-fpm
Ensure database credentials are correct and the database server is running.
Clear browser cache or try accessing via incognito mode.
Review your domain DNS settings to ensure proper pointing.
Confirm file permissions are correct for the vTiger directory.

If issues persist, revisit each step carefully, especially configuration files and service statuses.

Frequently Asked Questions

Can I install vTiger CRM with Apache instead of Nginx?

Yes, but this guide specifically covers Nginx. Instructions differ slightly for Apache, mainly in configuration files.

Is it necessary to use SSL with vTiger?

For security, especially if accessing sensitive data, enabling HTTPS with SSL certificates is highly recommended.

How do I update vTiger after installation?

Download the latest version, back up your database and files, then follow vTiger update instructions or perform a fresh reinstall.

What resources are recommended for hosting vTiger?

A server with at least 2GB RAM, a modern CPU, and SSD storage is recommended for optimal performance.

Can I install vTiger on a shared hosting environment?

It’s possible if the environment supports PHP and database setup; however, a VPS or dedicated server is preferable for better control and performance.

How secure is vTiger CRM?

Security depends on proper configuration, regular updates, secure passwords, and HTTPS. Always follow best security practices.

How to Install vTiger CRM with Nginx on Ubuntu 24.04

How to Install vTiger CRM with Nginx on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Can I install vTiger CRM with Apache instead of Nginx?

Is it necessary to use SSL with vTiger?

How do I update vTiger after installation?

What resources are recommended for hosting vTiger?

Can I install vTiger on a shared hosting environment?

How secure is vTiger CRM?

Related