How to Install vTiger CRM with Apache on Ubuntu 24.04

Setting up vTiger CRM on your Ubuntu 24.04 server with Apache allows you to efficiently manage customer relationships, sales, marketing, and support all in one platform. This guide walks you through the entire process, from preparing your server to configuring vTiger for optimal use. Before starting, ensure your server has a fresh Ubuntu 24.04 installation, root or sudo access, and an active internet connection. Having basic knowledge of Linux commands and server management will help you follow along smoothly.

What You’ll Need

• Ubuntu 24.04 Server with root or sudo privileges
• Domain name pointed to your server’s IP (optional but recommended)
• Basic knowledge of Linux command line
• Internet connection for downloading packages
• Optional: SSL certificate for HTTPS (recommended for production)

Step-by-Step

1. Update Your System

Start by updating your system repositories and packages to ensure you have the latest versions. Run:

sudo apt update && sudo apt upgrade -y

2. Install Apache, PHP, and Necessary Dependencies

vTiger requires a LAMP stack. Install Apache, PHP, and required PHP modules:

sudo apt install apache2 php php-cli php-common php-mysql php-xml php-mbstring php-curl php-zip php-gd php-bcmath php-intl php-soap php-ldap php-xmlrpc php-bcmath -y

3. Install MySQL Server

Set up the database for vTiger:

sudo apt install mysql-server -y
sudo mysql_secure_installation

> Follow prompts to secure your MySQL installation. Then, create a database and user:

sudo mysql -u root -p

> Inside MySQL shell:

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;

4. Download vTiger CRM

Navigate to the official vTiger website or GitHub repository to get the latest stable release. Use wget to download:

cd /tmp
wget https://sourceforge.net/projects/vtigercrm/files/vtiger%20crm/7.6.0/vtigercrm7.6.0.tar.gz/download -O vtigercrm.tar.gz

5. Extract and Configure vTiger

Move the archive to the web directory and extract:

sudo tar -xzvf vtigercrm.tar.gz -C /var/www/html/
sudo mv /var/www/html/vtigercrm-7.6.0 /var/www/html/vtiger

> Set proper permissions:

sudo chown -R www-data:www-data /var/www/html/vtiger
sudo chmod -R 775 /var/www/html/vtiger

6. Configure Apache Virtual Host

Create a new virtual host configuration:

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

> Add the following content, replacing your domain if applicable:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/html/vtiger
    <Directory /var/www/html/vtiger>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/vtiger_error.log
    CustomLog ${APACHE_LOG_DIR}/vtiger_access.log combined
</VirtualHost>

> Enable the site and rewrite module:

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

7. Complete the Web Installer

Open your browser and navigate to http://your_server_ip or http://yourdomain.com. Follow the on-screen instructions:

• Choose language and accept license agreement.
• Enter database details: database name, username, and password.
• Create an admin account with username and password.
• Configure email and other preferences as prompted.

> Once completed, remove the install directory for security:

sudo rm -rf /var/www/html/vtiger/install

8. Secure Your Installation

For production, set up SSL with Let’s Encrypt or another provider to serve vTiger over HTTPS. For example, with certbot:

sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d yourdomain.com

Common Mistakes

• Forgetting to set correct permissions on the vTiger directory, leading to access issues.
• Not configuring the database properly or using incorrect credentials during installation.
• Skipping the removal of the install directory, which can pose security risks.
• Forgetting to enable Apache rewrite module, preventing URL rewriting and causing errors.
• Not securing the server with SSL, making data vulnerable during transmission.

Tips

• Always keep your server updated to patch security vulnerabilities.
• Back up your database regularly, especially before upgrades or major changes.
• Use strong, unique passwords for database and admin accounts.
• Configure email settings properly for notifications and password resets.
• Consider setting up a dedicated user for the vTiger database for added security.
• Use HTTPS in production to encrypt data transmitted between server and clients.

Troubleshooting

If vTiger CRM does not load correctly or you encounter errors:

• Check Apache error logs: Run sudo tail -f /var/log/apache2/error.log to identify server issues.
• Verify database connection: Ensure your database credentials are correct and the database is accessible.
• Ensure permissions are correct: Files should be owned by www-data and have proper permissions.
• Disable SELinux/AppArmor temporarily: Sometimes security modules block access; check logs and disable if necessary.
• Clear browser cache or try incognito mode: Sometimes, cached data causes display issues.
• Revisit the installation steps: Ensure all steps were followed correctly, especially permissions and configuration files.

Frequently Asked Questions

1. Can I install vTiger CRM with other web servers like Nginx?

Yes, but this guide covers Apache. Installing with Nginx requires different configuration steps, especially for URL rewriting.

2. Is vTiger CRM free?

Yes, vTiger CRM is open-source and free to use, but some add-ons and services may be paid.

3. How do I upgrade vTiger CRM later?

Upgrade involves backing up your database and files, downloading the latest version, and following the upgrade instructions provided by vTiger.

4. Can I run vTiger CRM on a local network instead of the internet?

Yes, by configuring your server’s network settings and DNS, you can access vTiger locally without exposing it to the internet.

5. How do I secure vTiger CRM after installation?

Use SSL certificates, set strong passwords, restrict access via firewalls, and keep your system updated regularly.

6. Is it necessary to install additional PHP modules?

Most required modules are included, but verify the vTiger documentation for specific dependencies or optional modules for enhanced features.

Related

• How to Import an Excel Spreadsheet into InDesign Easily
• How to Hide Your Number During Calls on Android
• How to Hide Your Mobile Screen on Windows 11 for Privacy