Installing SuiteCRM on your own server gives you complete control over your CRM — no vendor lock-in, no per-user fees, and unlimited customization potential. Whether you’re a system administrator deploying for your company or a developer setting up a test environment, this guide walks you through every step of the SuiteCRM installation process.
We’ll cover both SuiteCRM 7 (the mature, widely-deployed version) and SuiteCRM 8 (the modern Angular-based version), including system requirements, server setup, database configuration, and essential post-installation steps. If you’d rather skip the technical setup entirely, consider SuiteCRM OnDemand for a fully managed cloud deployment.
System Requirements & Compatibility Matrix
Before starting the SuiteCRM installation, verify that your server meets the minimum requirements.
SuiteCRM 8.x Requirements (Current Release)
The latest SuiteCRM 8.9.x requires the following stack: your operating system should be Linux, Unix, or Mac OS (Windows Server 2019+ is supported but Linux is strongly recommended). For PHP, you need version 8.1, 8.2, or 8.3 — note that PHP 7.4 is no longer supported from SuiteCRM 8.7 onwards. Your web server should be Apache 2.4 with mod_rewrite enabled. For the database, MariaDB 10.4–10.11 or MySQL 5.7/8.0 is required.
You’ll also need these PHP extensions: mysql, curl, xml, mbstring, zip, intl, json, gd, tidy, opcache, soap, imap, and ldap.
SuiteCRM 7.x Requirements (Extended Support Release)
SuiteCRM 7.15 (the ESR release from December 2025) supports PHP 7.4 through 8.2, Apache 2.4 or IIS 10, MariaDB 10.3–10.11 or MySQL 5.7/8.0, and runs on Linux, Unix, Windows, or Mac OS.
Minimum Hardware Recommendations
For a small team (1–10 users), a VPS with 2 CPU cores, 4 GB RAM, and 40 GB SSD storage is sufficient. For medium teams (10–50 users), step up to 4 cores, 8 GB RAM, and 80 GB SSD. For large deployments (50+ users), plan for 8+ cores, 16 GB+ RAM, dedicated database server, and SSD storage with proper backup infrastructure.
Method 1: Installing SuiteCRM on Ubuntu/Debian (Recommended)
This is the most common deployment method. We’ll use Ubuntu 22.04 LTS with a full LAMP stack.
Step 1: Update Your System
Start by connecting to your server via SSH and updating all packages. Run the system update command to ensure you have the latest security patches and package versions before installing any new software.
Step 2: Install LAMP Stack
Install Apache, MariaDB, PHP, and all required PHP extensions. The key packages include apache2, mariadb-server, and PHP 8.2 with extensions for mysql, xml, mbstring, curl, zip, intl, json, gd, tidy, opcache, soap, imap, and ldap. After installation, verify that Apache and MariaDB are running properly.
Step 3: Configure MariaDB
Secure your MariaDB installation by running the security script, which sets a root password, removes anonymous users, disables remote root login, and removes the test database.
Then create the SuiteCRM database and user. Create a new database (for example, “suitecrmdb”), grant all privileges on that database to a dedicated user with a strong password, and flush privileges.
Step 4: Configure PHP
Edit your PHP configuration file (php.ini) to optimize settings for SuiteCRM. The key changes are: set memory_limit to at least 512M, upload_max_filesize to 20M, post_max_size to 20M, max_execution_time to 300, and max_input_time to 300. Set error_reporting to exclude notices and warnings for production environments.
Step 5: Download SuiteCRM
Download the latest SuiteCRM release from suitecrm.com/download or from the GitHub repository. For SuiteCRM 8, download the pre-built installable package ZIP — this includes the compiled frontend files and all required libraries, so you don’t need Node.js or npm for a production installation.
Extract the downloaded archive to your web server’s document root, typically /var/www/html/suitecrm. Set proper file permissions: directories should be 2755 and files should be 0644, all owned by the www-data user and group. Make the bin/console file executable for SuiteCRM 8.
Step 6: Configure Apache Virtual Host
Create a new Apache virtual host configuration for SuiteCRM. The configuration should specify your ServerName (your domain or IP address), set the DocumentRoot to your SuiteCRM directory, and include a Directory block that allows .htaccess overrides with AllowOverride All.
Enable the new site, enable the Apache rewrite module (required for SuiteCRM’s URL routing), and restart Apache.
Step 7: Run the SuiteCRM Installer
For SuiteCRM 7: Open your browser and navigate to http://your-domain/suitecrm. The installation wizard will guide you through accepting the license agreement, checking system requirements, configuring the database (enter your database name, hostname as “localhost”, and the credentials you created earlier), setting up the admin account, and configuring SMTP email settings.
For SuiteCRM 8: You have two options. The web-based installer works similarly to version 7 — navigate to your domain and follow the prompts. Alternatively, you can use the command-line installer by running the bin/console command with your database credentials, admin username, password, and site URL. The CLI method is faster and preferred for automated deployments.
Step 8: Post-Installation Configuration
After the installer completes, perform these essential steps:
Remove or restrict access to the installation directory for security. Set up the SuiteCRM Scheduler by adding a cron job that runs every minute — this is critical for workflows, email campaigns, and scheduled tasks to function properly. Configure your SMTP server under Admin → Email Settings so the system can send notifications and campaign emails. Run a Quick Repair and Rebuild from Admin → Repair to ensure all files are properly compiled.
Method 2: Installing SuiteCRM with Docker
Docker provides the fastest way to get SuiteCRM running, especially for development and testing environments.
Clone the community Docker repository, navigate into the directory, and run docker compose up. This spins up containers for Apache/PHP and MariaDB pre-configured for SuiteCRM. Within minutes, you’ll have a working instance accessible in your browser.
Docker is also excellent for production if your team is comfortable with container orchestration. It simplifies updates, scaling, and backup management.
Method 3: Installing via Softaculous (cPanel)
If your hosting provider uses cPanel with Softaculous, installation is simplified to a few clicks. Log into cPanel, open Softaculous Apps Installer, search for “SuiteCRM,” and follow the guided installation. This method handles Apache configuration, database creation, and file permissions automatically.
Note that Softaculous installations on shared hosting may have performance limitations. For serious business use, a VPS or dedicated server is recommended.
Securing Your SuiteCRM Installation
Security should be addressed immediately after installation:
Enable SSL/TLS. Install a free SSL certificate from Let’s Encrypt using Certbot. Configure Apache to redirect all HTTP traffic to HTTPS. SuiteCRM should always run over encrypted connections.
Configure the firewall. Only open ports 80 (HTTP), 443 (HTTPS), and 22 (SSH). Close all unnecessary ports.
Set proper file permissions. The config.php file should not be world-readable. Custom directories should be writable by the web server but not publicly accessible.
Enable SuiteCRM Security Groups. Configure role-based access control to ensure users only see data relevant to their role. This is especially important for businesses handling sensitive customer information.
Schedule regular backups. Automate daily database backups and weekly full-system backups. Store backups off-server.
For enterprise-grade security and compliance (GDPR, HIPAA), consider SuiteAssured — the enterprise-certified distribution of SuiteCRM.
Post-Installation: Essential Configuration Steps
Once SuiteCRM is installed and secured, complete these setup tasks:
Configure email. Set up inbound and outbound email accounts under Admin → Inbound Email and Admin → Email Settings. Test sending and receiving to verify SMTP/IMAP connectivity.
Customize modules. Use Studio (Admin → Studio) to add custom fields, modify layouts, and create dropdown lists tailored to your business. For deeper customization, see our guide on SuiteCRM customization.
Set up workflows. Create automated workflows for lead assignment, email notifications, status updates, and follow-up scheduling.
Build dashboards and reports. Configure custom dashboards for each team role — sales pipeline views, support case queues, and marketing campaign metrics.
Import data. If migrating from another CRM, use SuiteCRM’s import tool for CSV files or engage professional migration services for complex data transfers.
Install themes and plugins. Refresh the interface with a modern SuiteCRM theme and extend functionality with plugins from the SuiteCRM Store.
Train your team. User adoption determines CRM success. Invest in proper SuiteCRM training for admins, end users, and developers.
Performance Optimization Tips
After installation, these optimizations ensure SuiteCRM runs smoothly:
Enable OPcache. PHP OPcache dramatically improves performance by caching compiled PHP code. Verify it’s enabled in your PHP configuration.
Configure database indexing. Ensure commonly queried fields have proper indexes. SuiteCRM’s Repair tool can rebuild indexes when performance degrades.
Use a caching layer. For larger deployments, add Redis or Memcached to reduce database load and speed up page loads.
Monitor server resources. Track CPU, RAM, disk I/O, and database query performance. Slow queries are the most common performance bottleneck.
Optimize Scheduler frequency. The default cron runs every minute. For servers under load, adjust workflow scheduling frequency to balance automation speed with server resources.
SuiteCRM 7 vs SuiteCRM 8: Which Version to Install?
If you’re starting fresh in 2026, the choice depends on your needs:
Install SuiteCRM 7.15 (ESR) if you need maximum stability and community module compatibility. Version 7 has a much larger ecosystem of third-party modules and themes, more community documentation, and proven production reliability. The Extended Support Release guarantees updates for at least two more years. Most existing SuiteCRM development expertise targets version 7.
Install SuiteCRM 8.x if you want the modern Angular frontend, improved REST API architecture, better security model, and are building a new deployment from scratch. Note that some community modules built for version 7 may not yet be compatible with version 8.
For guidance on choosing the right version and deployment strategy, consult with a SuiteCRM partner. TechEsperto, as the Official SuiteCRM Professional Partner, can assess your requirements and recommend the optimal setup.
When to Use Professional Installation Services
While this guide covers DIY installation, professional SuiteCRM implementation services make sense when:
- You need the CRM production-ready on a tight timeline
- Your team lacks Linux/PHP server administration experience
- You’re migrating data from an existing CRM alongside installation
- Your deployment involves complex integrations with ERP, telephony, or marketing systems
- Compliance requirements (HIPAA, GDPR) demand validated security configuration
- You want to follow implementation best practices from day one
TechEsperto handles end-to-end SuiteCRM deployment — from server setup to customization, integration, training, and ongoing support.Contact us for a free consultation.
