HubDocs

Guides

Check and run apps

Inspect, stop, start, restart, or delete an app.

View Markdown

Find and open your app

CLI
hub apps
hub app my-app open

Replace my-app with the name shown in the list. You can also open it in Cloud Dashboard.

Check its health

CLI
hub app my-app status

Check the release and service states. Use logs if something is wrong.

The release shown by hub apps and status is the serving release. A newer failed attempt appears separately, so a failed release 2 does not replace serving release 1. Before any release has run, there is no serving release. See JSON fields for scripts.

Restart an app

CLI
hub app my-app restart
hub app my-app status

Restart uses the current build. To publish changed files, run hub deploy from the project folder.

Start, stop, restart, and suspend wait for completion by default, including with --json and MCP. Use --no-wait to return an operation ID immediately, then poll the operation.

Take an app offline

CLI
hub app my-app stop

Run hub app my-app start to bring it back. Deploying a new release also starts it.

To remove an app and every instance, use Delete on its dashboard page or hub app my-app rm. Ordinary app deletion retains volumes by default; selecting Also delete the data removes them. Recreating the same name starts with separate data, and neither the CLI nor dashboard offers a restore operation. Read storage and deletion before deleting.

Use staging · All app commands

On this page