How to Install Vtiger CRM
Complete Installation Guide
This guide covers everything you need for a successful Vtiger installation on Windows and Linux.
Whether you’re looking to install Vtiger CRM for the first time or need a detailed Vtiger CRM installation walkthrough, follow the steps below.
Before you begin, make sure you’ve completed the Vtiger download.
Before You Install Vtiger – Requirements
Component
- PHP:
- RAM:
- Disk space:
- MySQL / MariaDB:
- Web server:
- Operating system:
Requirement
- 7.4 or higher
- 2 GB minimum
- 10 GB+
- 5.7+ / 10.3+
- Apache or Nginx
- Linux (recommended) or Windows
Vtiger Installation on Windows
This method works on Windows 10 and Windows 11.
Step 1: Install XAMPP
Download XAMPP from apachefriends.org and install it. Start Apache and MySQL modules from the XAMPP Control Panel.
Step 2: Create a Database
Open http://localhost/phpmyadmin and create a new database named vtiger_db.
Step 3: Extract Vtiger Files
Extract the downloaded Vtiger zip file into C:\xampp\htdocs\vtiger\.
Step 4: Run the Web Installer
Open your browser and go to http://localhost/vtiger.
Step 5: Complete Setup
Follow the installation wizard, enter your database name, username root, and leave the password blank for local XAMPP. Create your admin account and choose whether to import sample data. Your Vtiger CRM installation on Windows is now complete.
Vtiger Installation on Linux (Ubuntu/Debian)
Step 1: Update Server and Install Dependencies
sudo apt update && sudo apt upgrade -y
sudo apt install apache2 mariadb-server php php-cli php-common php-mysql php-curl php-gd php-mbstring php-xml php-zip php-intl unzip -y
Step 2: Create Database
mysql -u root -p
CREATE DATABASE vtiger_db;
CREATE USER 'vtigeruser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON vtiger_db.* TO 'vtigeruser'@'localhost';
FLUSH PRIVILEGES;
Step 3: Upload and Extract Vtiger Files
unzip vtigercrm-*.zip -d /var/www/html/vtiger
sudo chown -R www-data:www-data /var/www/html/vtiger
sudo find /var/www/html/vtiger -type d -exec chmod 755 {} \;
sudo find /var/www/html/vtiger -type f -exec chmod 644 {} \;
Step 4: Run the Web Installer
Navigate to http://your-server-ip/vtiger and follow the setup wizard.
Vtiger Open Source Installation Guide – Post-Setup
- 1. Company profile — name, logo, timezone
- 2. SMTP email — for sending notifications and emails from CRM
- 3. User roles — set permissions for your team members
- 4. Import data — contacts, leads, accounts via CSV
Install Vtiger CRM – Common Errors & Fixes
Run the following command and restart Apache:
sudo apt install php-mysqli
Enable PHP error reporting or check /var/log/apache2/error.log. This is usually caused by a missing PHP extension.
Re-run the following command:
sudo chmod -R 755 /var/www/html/vtiger
Verify that the credentials in config.inc.php match your MySQL or MariaDB setup.
Vtiger Installation FAQ
How long does Vtiger installation take?
IT-Solutions4You2026-04-13T12:26:34+00:00A typical Vtiger CRM installation takes 15–30 minutes depending on your server setup.
Can I install Vtiger CRM on Windows 10?
IT-Solutions4You2026-04-13T12:26:52+00:00Yes. Installing Vtiger on Windows 10 using XAMPP is one of the easiest methods for local or development use.
Is the Vtiger installation free?
IT-Solutions4You2026-04-13T12:36:22+00:00Yes, the Vtiger install for the open source version is completely free.
What’s the difference between the Vtiger web installer and a manual installation?
IT-Solutions4You2026-04-13T12:35:49+00:00The Vtiger web installer is a browser-based setup wizard that automatically configures the database, creates tables, and guides you through the installation process step by step.
A manual installation requires you to configure the database, file permissions, and system settings yourself using command line and configuration files. It provides more control but requires technical knowledge.