SuiteCRM Installation Guide: System Requirements + Step-by-Step Setup

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 — from confirming SuiteCRM system requirements to running the installer to securing the production deployment.

We’ll cover both SuiteCRM 7 (the mature, widely-deployed version) and SuiteCRM 8 (the modern Angular-based version), including server setup, database configuration, security hardening, and essential post-installation steps. If you’d rather skip the technical setup entirely, consider SuiteCRM OnDemand for a fully managed cloud deployment, or have TechEsperto handle the install as part of a fixed-fee SuiteCRM implementation.

TL;DR — SuiteCRM Installation in 60 Seconds

• Operating system: Linux (Ubuntu 22.04 LTS recommended), Unix, or macOS. Windows Server works but isn’t recommended.
• PHP: 8.1, 8.2, or 8.3 for SuiteCRM 8 / 7.4–8.2 for SuiteCRM 7.
• Database: MariaDB 10.4–10.11 or MySQL 5.7 / 8.0.
• Web server: Apache 2.4 with mod_rewrite (NGINX also supported).
• Hardware minimum: 2 CPU, 4 GB RAM, 40 GB SSD for 1–10 users; scale up linearly.
• 3 install methods: Manual LAMP stack (most common), Docker (fastest), Softaculous/cPanel (easiest).
• Install time: 15–40 minutes manually; under 10 minutes via Docker.
• Cost: Software is $0. Server hosting from $50–$200/month VPS.

👉 Don’t want to do it yourself? Get a fixed-fee SuiteCRM install + customization quote in 48 hours.

SuiteCRM System Requirements (2026)

Before starting the installation, verify your server meets the requirements for the version you’re deploying.

SuiteCRM 8.x System Requirements (Current Release)

The latest SuiteCRM 8.9.x requires:

SuiteCRM 7.x System Requirements (Extended Support Release)

SuiteCRM 7.15 (the ESR release from December 2025) requires:

Minimum Hardware Recommendations by Team Size

For deeper hosting architecture guidance, see our SuiteCRM hosting guide and performance optimization guide.

Pre-Install Checklist

Before touching the installer, confirm these:

• ✅ A VPS, dedicated server, or cloud instance (AWS EC2, DigitalOcean Droplet, Azure VM, GCP Compute Engine, Linode, Hetzner, or on-prem).
• ✅ Root SSH access (or a sudo-enabled user).
• ✅ A domain name pointing to your server (optional but recommended for SSL).
• ✅ Server clock synced (NTP enabled).
• ✅ Latest OS security patches applied.
• ✅ A backup plan defined (see our SuiteCRM backup strategy).
• ✅ TLS/SSL certificate plan (Let’s Encrypt is free and works fine).

Method 1: Install SuiteCRM on Ubuntu / Debian (Most Common)

This is the most common deployment method. We’ll use Ubuntu 22.04 LTS with a full LAMP stack. The same general approach works on Debian, RHEL, CentOS, Rocky Linux, and AlmaLinux with minor package-name adjustments.

Step 1: Update the System

Connect to your server via SSH and update 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 with systemctl status.

Step 3: Configure MariaDB

Secure your MariaDB installation by running mysql_secure_installation, 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.
• Flush privileges.

Step 4: Configure PHP

Edit your PHP configuration file (/etc/php/8.2/apache2/php.ini) to optimize settings for SuiteCRM:

Restart Apache after changes.

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: 2755
• Files: 0644
• Owned by: www-data:www-data
• Make bin/console 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 (domain or IP), set the DocumentRoot to your SuiteCRM directory, and include a Directory block that allows .htaccess overrides with AllowOverride All.

Enable the new site (a2ensite), enable the Apache rewrite module (a2enmod rewrite), 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 walks you through:

1. Accept the license agreement
2. System requirements check
3. Database configuration (name, hostname localhost, credentials from Step 3)
4. Admin account setup
5. SMTP email settings

For SuiteCRM 8: Two options:

• Web-based installer — same flow as version 7.
• Command-line installer — run bin/console suitecrm:app:install 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:

• Remove or restrict access to the installation directory for security.
• Set up the SuiteCRM Scheduler by adding a cron job that runs every minute — critical for workflows, email campaigns, and scheduled tasks. Full setup in our SuiteCRM Scheduler / cron setup guide.
• Configure your SMTP server under Admin → Email Settings. See our SuiteCRM email configuration guide for the deeper setup.
• Run Quick Repair and Rebuild from Admin → Repair to ensure all files are properly compiled.

Method 2: Install 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. Full step-by-step in our SuiteCRM Docker deployment guide.

Method 3: Install SuiteCRM via Softaculous (cPanel)

If your hosting provider uses cPanel with Softaculous, installation is simplified to a few clicks:

1. Log into cPanel
2. Open Softaculous Apps Installer
3. Search for “SuiteCRM”
4. 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.

Install SuiteCRM on AWS / Azure / GCP / DigitalOcean

The same Ubuntu LAMP stack works on every major cloud provider:

• AWS EC2 — launch a t3.medium (2 vCPU, 4 GB) Ubuntu 22.04 instance for small teams; m5.large (2 vCPU, 8 GB) for medium teams. Pair with RDS for MariaDB at scale.
• Azure VM — Standard_B2s (2 vCPU, 4 GB) Ubuntu 22.04 LTS image works fine for small teams.
• GCP Compute Engine — e2-medium (2 vCPU, 4 GB) for small teams; use Cloud SQL for managed MariaDB at scale.
• DigitalOcean Droplet — $24/month “Premium AMD” Droplet (2 vCPU, 4 GB, 80 GB SSD) is a popular sweet spot.
• Linode / Vultr / Hetzner — similar specs at lower cost; widely used for cost-conscious deployments.
• TechEsperto-managed SuiteCRM cloud — fully-managed deployment on AWS in your region, with backups, monitoring, security hardening, patching, and managed support included. See SuiteCRM cloud hosting.

For regulated industries (healthcare, fintech), our HIPAA + SuiteCRM setup and GDPR + SuiteCRM setup guides cover the compliance-aligned hosting patterns.

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. Consider moving SSH to a non-default port and restricting access to known IPs.

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 + Roles. Configure role-based access control to ensure users only see data relevant to their role. See our SuiteCRM Security Groups & Roles guide for the full configuration pattern.

Schedule regular backups. Automate daily database backups and weekly full-system backups. Store backups off-server. See our SuiteCRM backup strategy.

Disable directory listing, hide PHP version, set strict CORS headers. Standard Apache hardening — fail2ban for repeated login attempts, ModSecurity for application-layer WAF.

For enterprise-grade security and compliance (GDPR, HIPAA, SOC 2), 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. Full step-by-step in our SuiteCRM email configuration guide.

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 SuiteCRM customization complete guide.

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 After Install

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

Full breakdown in our SuiteCRM performance optimization guide.

SuiteCRM 7 vs SuiteCRM 8: Which Version to Install?

If you’re starting fresh, 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.
• You need the improved REST API architecture.
• You want a better security model.
• You’re building a new deployment from scratch.
• Note that some community modules built for version 7 may not yet be compatible with version 8.

For the deeper comparison, see our SuiteCRM 7 vs SuiteCRM 8 breakdown.

DIY Install vs Professional Implementation: How to Decide

A practical framework for whether to install SuiteCRM yourself or hire help:

TechEsperto delivers end-to-end SuiteCRM deployment — server setup, security hardening, customization, integration, training, and ongoing support — as a fixed-fee project. See our SuiteCRM implementation service, implementation timeline, and implementation best practices.

Frequently Asked Questions

What are the minimum SuiteCRM system requirements?

For SuiteCRM 8.x: Linux (Ubuntu / Debian / RHEL preferred), PHP 8.1+, Apache 2.4 with mod_rewrite, MariaDB 10.4+ or MySQL 5.7/8.0, and required PHP extensions (mysql, curl, xml, mbstring, zip, intl, json, gd, tidy, opcache, soap, imap, ldap). Minimum hardware: 2 CPU cores, 4 GB RAM, 40 GB SSD for a 1–10 user team. For SuiteCRM 7.x: same OS and database requirements, PHP 7.4 through 8.2.

How long does it take to install SuiteCRM?

A basic installation on a pre-configured LAMP server takes 15–40 minutes. Docker installation takes under 10 minutes. Full production deployment with customization, data migration, security hardening, and testing typically takes 1–4 weeks depending on complexity. See our full SuiteCRM implementation timeline.

Can I install SuiteCRM on shared hosting?

Technically yes, if the hosting supports PHP 8.1+ and provides MySQL/MariaDB access. However, shared hosting has significant performance limitations — subpanels, reports, and workflows slow down quickly. A VPS starting at $50/month is strongly recommended for any business use.

What’s the minimum server requirement for SuiteCRM?

A VPS with 2 CPU cores, 4 GB RAM, and 40 GB SSD storage is the minimum for a small team (1–10 users). For 50+ users, plan for 8 cores, 16 GB RAM, and dedicated database resources. See the hardware requirements table above for sizing by team scale.

What PHP version does SuiteCRM need?

SuiteCRM 8.7+ requires PHP 8.1, 8.2, or 8.3 (PHP 7.4 is no longer supported). SuiteCRM 7.15 supports PHP 7.4 through 8.2. Always run a supported PHP version for security patches.

Should I install SuiteCRM 7 or SuiteCRM 8?

SuiteCRM 7.15 (ESR) is recommended for most production deployments due to its stability, extensive module ecosystem, and guaranteed long-term support. SuiteCRM 8 is ideal for new projects that want the modern Angular architecture and don’t depend on legacy community modules. See our SuiteCRM 7 vs 8 comparison.

Is SuiteCRM installation free?

Yes — the software is completely free under AGPL. You only pay for server infrastructure (VPS hosting from $50–$200/month) and any professional services you choose for implementation, customization, or ongoing support.

How do I set up the SuiteCRM Scheduler (cron job)?

Add a cron entry that runs SuiteCRM’s cron.php file every minute using the web server’s PHP binary. This is essential — without it, workflows, email campaigns, and scheduled reports won’t execute. Verify it’s working by checking Admin → Schedulers → Process Workflow Tasks. Full step-by-step in our SuiteCRM Scheduler / cron setup guide.

Can I install SuiteCRM on AWS / Azure / GCP / DigitalOcean?

Yes — all major cloud providers work. A t3.medium EC2 instance (or equivalent on Azure, GCP, DigitalOcean) is the typical starting point for small teams. For HIPAA / GDPR-aligned deployments we typically deploy in customer’s AWS account in their region with managed backup and monitoring. See SuiteCRM cloud hosting.

Do I need Node.js or npm for SuiteCRM 8?

No — only for development from source. For production, download the pre-built installable package ZIP from suitecrm.com. It includes the compiled frontend files and all required libraries. Node.js/npm are only needed if you’re building the frontend from source.

Can I install SuiteCRM on NGINX instead of Apache?

Yes — NGINX 1.18+ with php-fpm 8.1+ is fully supported. The config is slightly different (NGINX uses try_files and rewrite directives instead of .htaccess). The rest of the install process is identical.

How do I upgrade from SuiteCRM 7 to SuiteCRM 8?

You must first upgrade to SuiteCRM 7.12.x, then migrate to 8.x. This isn’t a simple in-place upgrade — it involves data migration and reconfiguration of custom modules due to the architectural differences. See our SuiteCRM upgrade guide, or contact our team for professional migration support.

How do I secure my SuiteCRM after installation?

Enable HTTPS via Let’s Encrypt, restrict firewall to ports 22/80/443, harden file permissions (especially config.php), enable Security Groups + Roles, set up automated backups, and install fail2ban for SSH brute-force protection. For regulated industries, see our HIPAA + SuiteCRM and GDPR + SuiteCRM setup guides.

Can TechEsperto handle the installation for me?

What’s the difference between SuiteCRM OnDemand and self-installing SuiteCRM?

SuiteCRM OnDemand is a fully-managed cloud deployment — TechEsperto handles the server, security, backups, patching, and monitoring. Self-installing means you own the server administration. Both run the same SuiteCRM software; the choice is about who manages the infrastructure. Most small and mid-market teams prefer OnDemand to skip the sysadmin overhead.

What happens if I get stuck during install?

Ready to Deploy Your SuiteCRM?

You have three paths from here:

👉 Path 1 — DIY install (this guide). Free, full control, requires Linux/PHP comfort.

👉 Path 2 — SuiteCRM OnDemand — fully-managed cloud deployment. TechEsperto handles the server, security, backups, monitoring, and patching. You focus on using the CRM.

Not sure which path fits? Book a free 30-minute SuiteCRM consultation — bring your team size, technical resources, and timeline; leave with a recommendation.