Documentation
stackd docs
Everything the panel and the CLI can do, one page per feature. New here? Install the panel with the command on the home page, then read Architecture and the CLI.
Start here
Architecturestackd is a self-hosted platform as a service: you bring servers (bare metal or VPS), and stackd deploys apps to them an…The stackd CLIstackd, for Linux and macOS, deploys apps, sets their variables, follows their logs, runs one-off commands and opens she…Apps as code: stackd.tomlKeep your apps' settings in a stackd.toml in your repo: stackd apply makes the panel's apps match it, and stackd export …
Deploying
Apps built from gitstackd builds apps from a GitHub or GitLab repo (gitlab.com or self-hosted) and deploys each build, on every push if you…GitHub Actions runnersstackd can run your GitHub Actions jobs on your own servers. Settings → Runners keeps self-hosted runners there, each us…Docker Compose importTurn a Docker Compose file into stackd apps and managed databases, from Apps → New app → Docker Compose.App templatesTemplates start an app with an image, a port and variables that already fit stackd, plus the databases and volumes it ne…Preview environmentsAn app built from a repo can get a preview app per open pull request (GitHub) or merge request (GitLab), built and deplo…Canary releasesTry a new image on one web replica while the others keep serving the current one, then promote it everywhere or abort.Promotion and approvalsPromote an app's image from another app (staging to production), and protect an app so that its releases wait for an adm…Processes and release commandsRun a queue worker, a scheduler or any other long-running command beside an app's web replicas, from the same image, and…Scheduled jobsRun commands on a cron schedule, or once by hand, from an app's Jobs tab. Some templates come with jobs of their own (Fi…Variable groupsKeep a named set of variables once and give it to every app attached to it, from Settings → Variable groups and an app's…
Running
Health checks and deploys without downtimeGive an app an HTTP health check and a deploy only routes to a new replica once it's healthy, stops the one it replaces …AutoscalingScale an app's web replicas up and down with its CPU and requests, between a minimum and a maximum.Sleeping when idle (scale to zero)Let an app stop after a while without requests and start again on the next one. It suits previews, staging and side proj…Resource limitsSet memory and CPU limits per app, applied to each of its containers, in the app's Settings tab: Limits.Volumes: directories for appsA volume is a directory apps mount at a path, with the same files on every server they run on: for apps that keep files …Ceph volumesA Ceph volume (engine ceph) is a POSIX file system apps mount at a path, served by a Ceph cluster of the volume's own (C…
Data and mail
Managed databasesstackd runs MySQL, PostgreSQL, Redis and MongoDB for your apps, each as a single server or highly available, and links t…Sharded databasesstackd shards MySQL with Vitess and PostgreSQL with Citus, spreading a database's data over several groups of servers, w…Object storage (S3) on the serversstackd runs S3-compatible object storage on your own servers (engine s3, using Garage), on one server or highly availabl…Mail servicesA mail server for your own domains: mailboxes reached over IMAP, POP3, JMAP and SMTP submission from any mail app, and m…Your account and the mail serverEach user can change their own name, password and email in Settings → Account. Admins still manage roles and access in S…
Network
Domains: redirects, passwords, headers and wildcard certificatesA domain can redirect to another of its app's domains, an app can ask for a password and add headers to its responses, a…Ports: TCP and UDP beside HTTPAn app's web replicas can publish raw TCP and UDP ports on their servers, for what isn't HTTP: a game server, MQTT, SMTP…Maintenance mode and error pagesAn app can be put in maintenance, showing visitors a page while chosen addresses still reach it, and can have a page of …Web application firewall and honeypotEvery server's proxy runs a WAF in front of the apps. It blocks attacks, banned addresses and those threat feeds list. I…Traffic intelligenceThe panel's Traffic page is a control room for who visits the apps: where they come from (country, network), which serve…
Observability
LogsAn app's Logs tab shows its requests and its containers' output, live or from the last week, on every server or one, and…TerminalOpen a shell in any running replica of an app from the app's Terminal tab, with one-click artisan commands for Laravel a…Metrics for PrometheusGET /api/metrics serves the fleet's metrics in Prometheus' text format, for Prometheus, Grafana Alloy, an OpenTelemetry …Uptime and the status pageCheck your sites over HTTP from the panel, get alerts when they're down, and show them on a public status page (the Upti…AlertsGet told when servers, disks, memory, apps, databases, certificates, deploys, builds, backups, failovers or the firewall…
Servers and the panel
Cloud serversAdd server can make the machine as well, at Hetzner Cloud or DigitalOcean: it boots, installs the agent and joins by its…Host patchingThe agent keeps each server's packages up to date, and the panel reboots servers one at a time when an update needs it, …A highly available panelRun the panel on 3 to 9 of your servers so it survives losing one. A single panel's apps keep running if its server goes…Panel backupsA single panel can dump its own database once a day to an S3-compatible bucket, so losing its server doesn't lose the pa…
Access
Roles and projectsControl who can do what: admin, member and viewer roles, projects that limit members or viewers to some apps, databases …Single sign-onLet people sign in to the panel with an OpenID Connect provider (Google Workspace, Microsoft Entra, Okta, Auth0, Authent…Two-factor sign-inProtect accounts with a second factor: an authenticator app (TOTP), passkeys, or both, set up by each user in Settings →…Audit logEvery change made through the panel or the API, and every sign-in, is recorded in Settings → Audit log, for admins.