Skip to content

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.

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
  • All types: SSH (22) allowed.
  • Types that serve HTTP (app, web, lb): also 80 and 443.
  • Everything else is dropped.
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.

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.