Docs
Hangar documentation
How Hangar builds, deploys and runs your apps and databases: guides and reference for every part of the platform.
Quickstart
Deploy your first app on Hangar, from a Git repository to a public URL with HTTPS, in a few minutes.
ReadConnect GitHub, GitLab, Bitbucket or Gitea
Connect your Git host to Hangar once, choose which repositories it can see, and deploy any branch from them on every push.
ReadBuilds
How Hangar turns a repository into a running container, the builders you can choose from and when to use each one.
ReadDeploy a Docker image
Run a prebuilt Docker image on Hangar from Docker Hub, GHCR or a private registry, and redeploy it from your CI with a deploy hook.
ReadDocker Compose
Deploy a docker-compose.yml on Hangar from your repository or pasted in, as Docker Compose on one node or as a Swarm stack across the region.
ReadEnvironment variables
Set configuration and secrets for a Hangar service, and share values across services with project and environment variables.
ReadDomains and HTTPS
Give a Hangar service a public address, on a generated domain or your own, with a TLS certificate issued and renewed for you.
ReadDeployments and rollbacks
How Hangar deploys a service, how to trigger a deploy from your CI with a deploy hook, and how to roll back to an earlier release in seconds.
ReadPreview deployments
Deploy every GitHub pull request to its own URL on Hangar, with its own variables, and remove it automatically when the pull request closes.
ReadCron jobs
Run a command inside a Hangar service on a cron schedule, in your time zone, for cleanups, reports and queue drains, with a log of every run.
ReadDatabases
Create a managed PostgreSQL, MySQL, MariaDB, MongoDB, Redis or libSQL database on Hangar and connect it to your app.
ReadConnect to a database from outside
Turn on public networking to reach a Hangar database from your laptop, a BI tool or another cloud through its own TCP proxy address.
ReadVolumes
Keep files across deploys on Hangar with a persistent volume, attach it to any service, and back it up on a schedule or every 15 minutes.
ReadBackups and point-in-time recovery
Protect Hangar databases with point-in-time recovery to any second, scheduled dumps to your own S3 bucket, and restores that never overwrite your data.
ReadObservability
Logs, metrics, HTTP requests and OpenTelemetry traces for every Hangar service, with alerts on CPU, memory, error rate and latency.
ReadDeploy on Hangar button
Add a button to your README that lets anyone deploy your repository on Hangar in one click.
Read