Applications
Manage an application's lifecycle, deployments, build settings, and deletion.
An application is a service Out Plane runs from a Git repository or a container image. This page covers where you manage it, how deployments work, and the settings you can change.
The Application Page
Open an application from Applications. The header has a Restart button, a Logs button, and a More menu (open in browser, view metrics, settings). Below it, a tab bar:
| Tab | What it shows |
|---|---|
| Overview | Status, instances, endpoints, recent deployments, source, and configuration. |
| Deployments | Every build and release, with logs. |
| Shell | A terminal into a running instance. |
| Logs | Build and runtime logs. |
| HTTP Logs | Per request logs for public ports. |
| Metrics | CPU, memory, and traffic metrics. |
| Settings | General, Build, Environment, Network, and Scale settings. |
Deploying
For a Git application, pushing to the connected branch starts a new deployment automatically. You can also Restart to redeploy the latest source, or open the Deployments tab and choose Redeploy.
For an image application, open Deployments and choose Deploy. You can optionally enter a new image tag to deploy, or leave it empty to redeploy the current image.
Restarting or redeploying replaces the running instances. The Deployments tab lists every deployment, filterable by status and branch. Expand a row to follow its build logs.
Build Settings
Open Settings → Build. A Git application shows build options; an image application shows only its image reference.
| Setting | Notes |
|---|---|
| Build method | Dockerfile uses your Dockerfile. Buildpacks detects your stack and builds it. |
| Root directory | Build context relative to the repo root. Defaults to /. |
| Start command | Optional. Runs as a direct exec, so leave it empty to use the image default. For shell features such as &&, $VAR, or pipes, wrap it yourself: sh -c "…". |
| Build filters | Limit which changes trigger a build with allow and ignore glob lists. Ignore rules win, and a manual deploy ignores filters. |
Build settings take effect on the next build. Save stores them for later, and Save & deploy applies them immediately by starting a deployment.
General Settings
Open Settings → General.
| Field | Notes |
|---|---|
| Display name | How the app appears in the console. Up to 100 characters. |
| Internal name | The fixed identifier used in URLs and DNS. It cannot be changed. |
| App ID | The unique ID used by the API. |
Deleting an Application
In Settings → General, the Delete application card permanently removes the app along with its deployments, environment variables, and domain mappings. You confirm by typing the app's internal name. This cannot be undone.
An application with an attached volume cannot be deleted. Detach the volume first.