Documentation

Documentation

An app is a repository or a container image running on its own URL, with access you control and a snapshot you can go back to.

Start

Quickstart

From a repository to a running app on its own URL.

Build

How apps work

One app, one machine, up to four services behind one URL.

Sources

Deploy from a Git repository or a container image.

Services

How each service is reached, and how they reach each other.

Environment

Variables, secrets, and the rules for changing them.

Database

A Postgres database inside the app, and how to connect.

Operate

Deploys

What happens on a deploy, and which changes need a rebuild.

Versions

Every deploy is a version you can put back.

Snapshots

Take the whole app back to an earlier moment, data included.

Share

Access

Who can open your app, decided at the edge.

Custom domains

Point your own hostname at an app.

Reference

Limits

Every number, and where it comes from.

There is no public API yet — every app is created, configured, and deployed from the dashboard, and there is no endpoint or API key to build against today. If you came here looking for an API reference, that is the answer: the pages above are the whole surface.