Custom Apps

A custom app runs any Docker image you choose, from Docker Hub or your own registry. For private images, add a registry credential first.

Creating a custom app

1. Head over to your workspace’s “Apps” page in the sidebar, or the “Apps” tab of an instance
2. Open the dropdown next to “New App”
3. Hit “Custom App”
4. Choose the instance
5. Give the app a name
6. Enter the image, for example nginx:latest
7. Add environment variables, ports and volume mounts as your image needs
8. Hit “Create”

Serving a website

1. Open the custom app form, as in Creating a custom app
2. Tick “HTTP” on one TCP port
3. Choose a subdomain under “Custom Subdomain”

We point that address at the port. An app can have one HTTP port.

Storage

Add a volume mount for any folder your app writes data to, or the data is lost when the app is redeployed.

Type	Use it for
Volume	Data we manage for you, such as a database folder
Bind mount	A folder on the instance that you also want to reach over SSH or SFTP

Read more about managing, updating and deleting an app in Installing an App.