๐ Requirements
Before installing Monitron SaaS, make sure your server meets the following requirements. Don't worry โ we'll walk you through everything! ๐
๐ฅ๏ธ Server Requirementsโ
Minimum Hardwareโ
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 1 core | 2+ cores |
| RAM | 1 GB | 2+ GB |
| Disk | 10 GB | 20+ GB (depends on data retention) |
Tip: If you're monitoring fewer than 50 services with 1-minute intervals, a basic $5/month VPS (like DigitalOcean, Vultr, or Hetzner) will work great!
Operating Systemโ
Monitron SaaS runs on any OS that supports PHP 8.2+:
- โ Ubuntu 22.04 / 24.04 (recommended)
- โ Debian 11 / 12
- โ CentOS / Rocky / AlmaLinux 8 / 9
- โ Windows Server 2019 / 2022
- โ macOS (for local development)
๐ PHP Requirementsโ
PHP Version: 8.2 or higher (PHP 8.3 and 8.4 are fully supported)
Required PHP Extensionsโ
The installation wizard will check all of these for you, but here they are for reference:
| Extension | What It's For |
|---|---|
php-bcmath | Precise math calculations |
php-ctype | Character type checking |
php-curl | Making HTTP requests to monitors |
php-dom | XML/HTML parsing |
php-fileinfo | File type detection |
php-json | JSON encode/decode (usually built-in) |
php-mbstring | Multi-byte string support |
php-openssl | SSL/TLS operations |
php-pdo | Database connections |
php-tokenizer | PHP tokenization |
php-xml | XML support |
php-zip | ZIP file handling |
php-gd or php-imagick | Image processing (avatars, logos) |
Database-Specific Extensionsโ
You only need one of these, depending on your database choice:
| Database | Extension |
|---|---|
| MySQL 8.0+ | php-mysql (or php-pdo_mysql) |
| PostgreSQL 13+ | php-pgsql (or php-pdo_pgsql) |
| SQLite 3 | php-sqlite3 (or php-pdo_sqlite) |
Optional But Recommended Extensionsโ
| Extension | What It's For |
|---|---|
php-redis | If using Redis for caching/queues |
php-pcntl | Required for queue workers (Linux only) |
php-posix | Required for queue workers (Linux only) |
php-sockets | For TCP/UDP/WebSocket monitors |
๐พ Database Requirementsโ
You need one of the following databases:
| Database | Minimum Version | Notes |
|---|---|---|
| MySQL | 8.0+ | Most popular choice. MariaDB 10.3+ also works. |
| PostgreSQL | 13+ | Great for large installations. |
| SQLite | 3.x | Good for testing. Not recommended for production with high-frequency checks. |
SQLite Warning: SQLite works great for small setups (fewer than 10 monitors), but it can become a bottleneck with high-frequency checks (every 10-30 seconds) because it doesn't support concurrent writes well. For production, use MySQL or PostgreSQL.
๐ Web Serverโ
You need one of the following web servers:
| Web Server | Notes |
|---|---|
| Nginx 1.18+ | Recommended. Fast, lightweight, easy to configure. |
| Apache 2.4+ | Works great. Make sure mod_rewrite is enabled. |
| LiteSpeed / OpenLiteSpeed | Excellent performance. Great if you're already using it. |
| Caddy 2.x | Auto-HTTPS out of the box! Simplest config. |
| IIS 10+ | For Windows Server deployments. |
We provide ready-made configuration files for all of these! See the Web Server Configuration section.
๐ ๏ธ Additional Softwareโ
Requiredโ
| Software | Purpose |
|---|---|
| Composer 2.x | PHP package manager. Used to install dependencies. |
| Git (optional) | Only if deploying via Git. |
For Queue Workers (Required for Production)โ
| Software | Purpose |
|---|---|
| Supervisor (Linux) | Keeps queue workers running 24/7 |
| NSSM (Windows) | Service manager for Windows |
What are queue workers? Queue workers process monitoring checks in the background. Without them, checks run synchronously which is slower and less reliable. We'll set these up during installation!
๐ Network & Firewall Requirementsโ
Your Monitron server needs to be able to:
| Access | Port(s) | Why |
|---|---|---|
| Outbound HTTP/HTTPS | 80, 443 | To check HTTP monitors and send webhook notifications |
| Outbound ICMP | โ | For Ping monitors |
| Outbound TCP | Various | For TCP, SMTP, FTP, SSH, database monitors |
| Outbound DNS | 53 (UDP/TCP) | For DNS monitors |
| Inbound HTTP/HTTPS | 80, 443 | For the web interface and status pages |
Important: Some hosting providers block outbound ICMP (ping) by default. If Ping monitors always show "down," check with your hosting provider or use TCP monitors as an alternative.
๐ Recommended Stack Summaryโ
For the best experience, we recommend:
๐ง Ubuntu 24.04 LTS
๐ PHP 8.3
๐ Nginx
๐ฌ MySQL 8.0
๐ Redis (for caching & queues)
๐ฆ Supervisor (for queue workers)
๐ Let's Encrypt (for SSL)
This is the stack we test on most heavily and what most of our users run.
โ Ready?โ
If your server meets these requirements, you're ready to install! Head over to the Installation Guide.
Don't have a server yet? We recommend DigitalOcean, Vultr, or Hetzner for affordable, reliable VPS hosting. A $5-10/month plan is more than enough for most use cases.