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.

Vtiger installation page

Before You Install Vtiger – Requirements

To install Vtiger successfully, your server or local machine must meet these requirements:

Component

Requirement

Vtiger Installation on Windows

Vtiger installation on Windows is straightforward using XAMPP as a local server environment.
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)

For production environments, installing Vtiger on Linux is recommended for better performance and security.

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

After completing the Vtiger CRM install, configure these essential settings:

Install Vtiger CRM – Common Errors & Fixes

"mysqli extension not found"

Run the following command and restart Apache:

sudo apt install php-mysqli
Blank white page after installer

Enable PHP error reporting or check /var/log/apache2/error.log. This is usually caused by a missing PHP extension.

"Permission denied" on file write

Re-run the following command:

sudo chmod -R 755 /var/www/html/vtiger
Database connection failed

Verify that the credentials in config.inc.php match your MySQL or MariaDB setup.

Vtiger Installation FAQ

Find answers about Vtiger Installation.

A typical Vtiger CRM installation takes 15–30 minutes depending on your server setup.

Yes. Installing Vtiger on Windows 10 using XAMPP is one of the easiest methods for local or development use.

Yes, the Vtiger install for the open source version is completely free.

The 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.

Already using Vtiger CRM?

Extend your CRM with powerful modules.

Ready to get started?

First download Vtiger CRM, then follow this guide.