System Requirements
Hardware and software requirements for running Supascale.
Before installing Supascale, ensure your server meets these requirements.
Minimum Requirements
| Resource | Minimum | Recommended |
|---|---|---|
| RAM | 2 GB | 4 GB+ |
| Disk Space | 20 GB | 50 GB+ |
| CPU | 1 core | 2+ cores |
| Storage Type | HDD | SSD |
Software Requirements
Operating System
Supascale is designed for Linux servers:
| OS | Version | Support |
|---|---|---|
| Ubuntu | 20.04 LTS+ | Full |
| Debian | 11+ | Full |
| CentOS | 8+ | Full |
| RHEL | 8+ | Full |
| Fedora | 35+ | Full |
Required Software
The installer will check for and optionally install these:
| Software | Version | Purpose |
|---|---|---|
| Node.js | 18+ (20 recommended) | Application runtime |
| npm | 9+ | Package management |
| Docker | 20.10+ (24 recommended) | Container runtime |
| Docker Compose | v2+ | Container orchestration |
| PM2 | Latest | Process management |
Optional Software
| Software | Purpose |
|---|---|
| Nginx | Reverse proxy (recommended) |
| Apache | Alternative reverse proxy |
| Caddy | Alternative with auto-HTTPS |
| Certbot | Let's Encrypt certificates |
| UFW | Firewall management |
Network Requirements
Ports
| Port | Service | Required |
|---|---|---|
| 80 | HTTP | Yes (for Let's Encrypt) |
| 443 | HTTPS | Recommended |
| 3000 | Supascale (default) | Internal |
| 5432+ | PostgreSQL (projects) | Internal |
| 8000+ | API Gateway (projects) | Optional |
Firewall
If using UFW, the installer can configure:
# Allow HTTP/HTTPS sudo ufw allow 80/tcp sudo ufw allow 443/tcp
DNS
For custom domains and SSL:
- A/AAAA records pointing to your server
- DNS propagation complete before SSL setup
Resource Scaling
Per Project
Each Supabase project requires additional resources:
| Resource | Additional Requirement |
|---|---|
| RAM | ~1 GB per project |
| Disk | ~5 GB per project (varies) |
| CPU | Shared, scales with load |
Example Configurations
Small (1-3 projects)
- 4 GB RAM
- 40 GB SSD
- 2 CPU cores
Medium (4-10 projects)
- 8 GB RAM
- 100 GB SSD
- 4 CPU cores
Large (10+ projects)
- 16+ GB RAM
- 200+ GB SSD
- 8+ CPU cores
- Consider distributed setup
Pre-Installation Checklist
- [ ] Linux server with root/sudo access
- [ ] Minimum 2 GB RAM available
- [ ] Minimum 20 GB disk space
- [ ] Docker installed and running
- [ ] Node.js 18+ installed
- [ ] SSH access to server
- [ ] Valid Supascale license