> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/administration-guide/admin-guide/installation/server-requirements.md).

# Server Requirements

Before installing Chamilo 3.0, verify that your server meets the following requirements.

## Software Requirements

### PHP

| Requirement     | Minimum | Recommended |
| --------------- | ------- | ----------- |
| **PHP version** | 8.3     | 8.5         |

### Required PHP Extensions

| Extension                        | Purpose                                                                      |
| -------------------------------- | ---------------------------------------------------------------------------- |
| **curl**                         | HTTP requests (API integrations, external services)                          |
| **fileinfo**                     | MIME type detection for uploaded files                                       |
| **gd**                           | Image processing (thumbnails, CAPTCHA)                                       |
| **intl**                         | Internationalization (date, number, and string formatting)                   |
| **json**                         | JSON encoding/decoding                                                       |
| **ldap**                         | LDAP connector. Although you will probably not use LDAP, Chamilo requires it |
| **mbstring**                     | Multibyte string handling (UTF-8 support)                                    |
| **openssl**                      | Cryptographic operations (HTTPS, password hashing, tokens)                   |
| **pdo\_mysql** or **pdo\_pgsql** | Database connectivity (install the one matching your database)               |
| **xml**                          | XML parsing (SCORM, RSS, SOAP)                                               |
| **zip**                          | Handling ZIP archives (SCORM packages, bulk imports/exports)                 |
| **apcu**                         | User-level caching (recommended)                                             |
| **opcache**                      | Opcode caching (strongly recommended for performance)                        |
| **xapian**                       | Full-text search (optional, only if you use search)                          |

### Database

| Database    | Minimum Version |
| ----------- | --------------- |
| **MySQL**   | 8.0             |
| **MariaDB** | 10.4            |

### Web Server

| Server     | Notes                                                                                                               |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| **Apache** | Requires `mod_rewrite` enabled.                                                                                     |
| **Nginx**  | Requires manual configuration for URL rewriting. See the Symfony Nginx documentation for a reference configuration. |

### Build Tools

| Tool              | Purpose                                                                 |
| ----------------- | ----------------------------------------------------------------------- |
| **Composer**      | PHP dependency management. Required to install Chamilo's PHP libraries. |
| **Node.js** (18+) | JavaScript runtime. Required to build frontend assets.                  |
| **npm**           | JavaScript package manager. Installed with Node.js.                     |

## Hardware Requirements

| Resource       | Minimum                 | Recommended                                                 |
| -------------- | ----------------------- | ----------------------------------------------------------- |
| **RAM**        | 2 GB                    | 4 GB or more                                                |
| **CPU**        | 1 core                  | 2+ cores                                                    |
| **Disk space** | 2 GB (application only) | 20+ GB (including uploaded content)                         |
| **Disk type**  | HDD                     | SSD (significantly improves database and cache performance) |

These are baseline figures. Actual requirements depend on the number of concurrent users and the volume of content hosted.

## Operating System

| OS          | Notes                                                                |
| ----------- | -------------------------------------------------------------------- |
| **Linux**   | Recommended. Ubuntu 22.04+, Debian 12+, AlmaLinux 9+, or equivalent. |
| **Windows** | Possible but not thoroughly tested. Use WSL2 for development.        |
| **macOS**   | Development only / untested.                                         |

## Network Requirements

* A domain name pointing to your server.
* An SSL/TLS certificate for HTTPS (Let's Encrypt provides free certificates).
* Outbound SMTP access if sending emails directly (or use a third-party email service).
* Port 443 (HTTPS) and optionally port 80 (HTTP, for redirect to HTTPS).

## Checking Requirements

After placing the Chamilo source on your server, you can check your PHP configuration directly:

```bash
php -m          # List installed extensions
php -i          # Full PHP info
```

## Tips

* **Use PHP-FPM** with Apache or Nginx for better performance than mod\_php.
* **Separate your database** onto a dedicated server for platforms expecting more than 500 concurrent users.
* **Use SSD storage** -- Database-heavy applications like Chamilo benefit significantly from fast disk I/O.