Installing an App

Apps are Docker containers we set up and run on one of your instances. Pick a template, and we set up the container, its storage and a web address for it.

The instance must be running a Linux template. The first app installation might take extra time as we set up Docker and other necessary tooling.

Installing from a template

1. Head over to your workspace’s “Apps” page in the sidebar, or the “Apps” tab of an instance
2. Hit “New App”
3. Pick a template
4. Hit “Set up”
5. Choose the instance
6. Give the app a name
7. If the template serves a website, choose a subdomain under “Custom Subdomain”
8. Fill in any required fields
9. Hit “Deploy”

The app shows on the “Apps” page with its status.

Managing an app

Open an app’s menu to access common features:

Logs

Shows the container log output.

Power Controls

Stop, start and restart the app container.

Edit

Updates any container details such as the image, environment variables, ports or mounts. Clicking “Save & Redeploy” applies them and restarts the app.

Delete

Removes the container and deletes its data volumes.

Danger

“Delete” permanently erases the app’s volumes and their data unless you untick “Also delete the app’s volumes and their data”. Files in bind-mounted host folders are never deleted.

Updating an app

1. Head over to your workspace’s “Apps” page in the sidebar
2. Hit “Edit” in the app’s menu
3. Change the image tag to the new version
4. Hit “Save & Redeploy”

Read more about running your own Docker image in Custom Apps.