Server types
Every server has a type, chosen when you create it. The type limits which software can be installed and what the server can host.
| Type | Value | Description | Hosts sites | Serves HTTP | Software you can pick |
|---|---|---|---|---|---|
| App server | app |
All-in-one: PHP, Node, sites and database containers on one machine | ✓ | ✓ | PHP, Node |
| Web server | web |
Serves sites behind Caddy / FrankenPHP; databases live elsewhere | ✓ | ✓ | PHP, Node |
| Database server | db |
For database containers (any server can run them) | none | ||
| Cache server | cache |
For Redis / Valkey containers (any server can run them) | none | ||
| Worker server | worker |
Queue workers, daemons and scheduled tasks; no public web traffic | ✓ | PHP, Node | |
| Load balancer | lb |
Caddy load balancer in front of web servers | ✓ | none | |
| Builder | builder |
Builds releases and images (Railpack / BuildKit) for other servers | Node |
Since v0.10.0 every server runs Docker (with live-restore), so Docker is no longer a choice, and databases are never installed on the host: every database is a container that any server can run. A database or cache server is a server labelled for that role.
Software options
Section titled “Software options”| Component | Options |
|---|---|
| PHP runtime | FrankenPHP (default) or PHP-FPM |
| PHP versions | 8.1, 8.2, 8.3, 8.4 (default), 8.5 |
| Node.js | 20, 22 (default), 24 |
| Docker | Docker Engine with Compose v2 and Buildx, on every server |
Firewall defaults
Section titled “Firewall defaults”- All types: SSH (22) allowed.
- Types that serve HTTP (
app,web,lb): also 80 and 443. - Everything else is dropped.
Recommended layouts
Section titled “Recommended layouts”| Stage | Layout |
|---|---|
| Side project | 1 × app (sites + database containers) |
| Small production | 1 × app or web + 1 × db |
| Growing | 2+ × web + 1 × lb + 1 × db + 1 × cache + 1 × worker |
| Docker/Compose builds | add 1 × builder with Docker |
Keep the control plane on its own host in every layout.
Changing a type
Section titled “Changing a type”The type is chosen at creation. To change it, create a new server of the right type, move sites to it (Settings → Servers), and delete the old one.