Connecting Your Server
Server Requirements & Connection
Supported Operating Systems
| OS | Versions | Status |
|---|---|---|
| Debian | 11 (Bullseye), 12 (Bookworm), 13 (Trixie) | Fully supported |
| Ubuntu | 22.04 LTS, 24.04 LTS | Fully supported |
Minimum Requirements
- RAM: 512MB minimum, 1GB recommended, 2GB+ for multiple sites
- Disk: 10GB minimum (SSD recommended)
- CPU: 1 vCPU minimum
- Network: Public IPv4 address
- Access: Root or sudo privileges
- State: Fresh OS install (no existing web server or database)
Recommended VPS Providers
BlitzPress works with any VPS provider. Popular choices include:
- Hetzner — best value in EU (from ~$4/mo)
- DigitalOcean — simple, developer-friendly
- Vultr — global locations, good pricing
- Linode / Akamai — reliable, mature platform
- OVH / OVHcloud — budget EU servers
- AWS Lightsail — if you’re in the AWS ecosystem
Installation
From the BlitzPress panel, click “Connect Server” to get your server token. Then SSH into your VPS and run:
curl -sSL /install | bash -s -- <your-server-token>What Gets Installed (v1.3)
The install script performs these steps automatically:
| Step | Component | Details |
|---|---|---|
| 1 | OS Detection | Identifies Debian/Ubuntu, validates version |
| 2 | Base Packages | curl, python3, jq, git, rclone |
| 3 | OpenLiteSpeed | Web server on ports 80/443 with QUIC/HTTP3 |
| 4 | PHP | 8.5, 8.4, 8.3 (default), 8.2, 8.1, 7.4 with full extensions |
| 5 | Database | Percona Server (preferred) or MariaDB, WordPress-tuned |
| 6 | Redis | 256MB LRU, disabled persistence (caching only) |
| 7 | WP-CLI | WordPress command-line management |
| 8 | BorgBackup | Incremental, deduplicated backups |
| 9 | Docker + Compose | For Postal mail server and container apps |
| 10 | Security | UFW firewall, fail2ban, unattended-upgrades, acme.sh |
| 11 | Malware Scanning | ClamAV + Linux Malware Detect (on-demand) |
| 12 | BlitzPress Agent | 42 command modules, 7 mu-plugins, systemd service |
Firewall Ports
| Port | Protocol | Service | Required |
|---|---|---|---|
| 22 | TCP | SSH | Yes |
| 80 | TCP | HTTP (SSL verification) | Yes |
| 443 | TCP+UDP | HTTPS + QUIC/HTTP3 | Yes |
| 7080 | TCP | OLS Admin Console | Optional |
| 25 | TCP | SMTP (Postal) | Only if using email |
| 587 | TCP | SMTP Submission | Only if using email |
After Installation
The installer outputs a summary including:
- Stack versions (OLS, PHP, Percona/MariaDB, Redis, Docker)
- OLS Admin URL (
https://your-ip:7080) - Open ports
- Agent status
Your server will appear in the panel dashboard within 60 seconds (first heartbeat).
Agent Files
| Path | Purpose |
|---|---|
/opt/blitzpress/agent.py |
Main agent daemon |
/opt/blitzpress/config.json |
Server ID, token, panel URL |
/opt/blitzpress/commands/ |
42 command modules |
/opt/blitzpress/mu-plugins/ |
7 WordPress mu-plugins |
Troubleshooting
Server not appearing in panel?
- Check agent is running:
systemctl status blitzpress-agent - Check agent logs:
journalctl -u blitzpress-agent -f - Verify outbound HTTPS (agent connects to
app.blitzpress.dev) - Check config:
cat /opt/blitzpress/config.json
Installation failed?
- Ensure the VPS has a fresh OS install (no existing Apache/Nginx)
- Run as root:
sudo su -then the install command - Check minimum RAM:
free -h(need at least 512MB) - Re-run the install — it’s idempotent (safe to run multiple times)