Apps

Apps runs a container image, a compose file, or a repository the platform builds, on machines of your own behind a domain with a certificate. It provisions the machines, pulls your images, checks that the published service answers, and only then moves the domain onto the new version.

Get started

  • What is Apps?

    Apps runs a container image, a compose file, or a repository the platform builds, on machines of your own behind a domain with a certificate.

  • Deploy your first app

    Deploy a public container image, open it at its default URL, read what the deployment did, and delete it again, in about ten minutes.

Popular tasks

  • Create an app from an image

    Create an app that runs a container image from your registry or any public registry.

  • Create an app from a repository

    Bring code from GitHub, GitLab or any git host into Git, then create an app the platform builds from it with a Dockerfile or Railpack.

  • Deploy an app

    Start a deployment of an app, wait for it to go live, follow its build log, or stop it.

  • Set environment variables

    Give an app plain variables and secrets by reference, and roll the change out with or without a redeploy.

  • Bind a managed database

    Bind an app to a managed Postgres database so that every rollout generates DATABASE_URL and the PG variables from the database's current endpoint and credential.

  • Deploy from GitHub Actions

    Build your image in GitHub Actions or any CI, push it, and deploy it to an app with one command that waits for the result and fails the job when the deployment fails.

Operate and secure

  • What runs on your machines

    What runs on an app's machines and build machines, what the platform sees of them, and how they behave when something fails.

  • Security in Apps

    The IAM actions that govern apps, the permissions each operation needs beyond its own, what is audited, how secrets reach a machine, and what is exposed to the internet.

  • Monitoring apps

    The metrics, alarms, logs, activity and events an app produces, and where to read each.

  • Troubleshooting Apps

    Symptoms you can hit when creating, deploying and running an app, with their cause and fix.

Guides and references