Bloqd Server
The central Bloqd server can run on any system that supports Docker or Node.js.
Docker Deployment (Recommended)
| Requirement | Minimum | Recommended |
|---|
| Docker | 20.10+ | Latest |
| Docker Compose | 2.0+ | Latest |
| RAM | 512 MB | 1 GB |
| CPU | 1 core | 2 cores |
| Disk | 1 GB | 5 GB |
Manual Deployment
| Requirement | Version |
|---|
| Node.js | 20.0+ (LTS) |
| npm | 10.0+ |
| RAM | 512 MB |
| Disk | 1 GB |
Network Requirements
| Port | Protocol | Purpose |
|---|
| 3000 | TCP | HTTP API & Dashboard |
| 443 | TCP | HTTPS (if using reverse proxy) |
The server needs outbound internet access for:
- AbuseIPDB API (optional)
- Discord webhooks (optional)
- SMTP server (optional)
Agent Requirements
The Bloqd agent runs on each server you want to manage.
Supported Operating Systems
| Distribution | Versions | Package Manager |
|---|
| Ubuntu | 20.04, 22.04, 24.04 | apt |
| Debian | 11, 12 | apt |
| Rocky Linux | 8, 9 | dnf |
| AlmaLinux | 8, 9 | dnf |
| CentOS | 8, 9 (Stream) | dnf |
| RHEL | 8, 9 | dnf |
| Fedora | 38+ | dnf |
Software Requirements
| Requirement | Version | Notes |
|---|
| Python | 3.10+ | Required |
| fail2ban | 0.11+ | Required |
| curl | any | For installation |
| jq | any | For JSON parsing |
| systemd | any | For service management |
Hardware Requirements
| Resource | Minimum |
|---|
| RAM | 128 MB (agent only) |
| Disk | 50 MB |
Network Requirements
The agent needs outbound access to:
- Bloqd server (HTTP/HTTPS on configured port)
- No inbound ports required
Browser Compatibility
The Bloqd dashboard works with modern browsers:
| Browser | Minimum Version |
|---|
| Chrome | 90+ |
| Firefox | 88+ |
| Safari | 14+ |
| Edge | 90+ |
License Limits
Depending on your license tier, there are limits on the number of servers:
| Tier | Max Servers |
|---|
| Free | 1 |
| Personal | 5 |
| Pro | Unlimited |
See Licensing for more details.