Install the CLI. See the install docs.
Log in:
runway login
Add an SSH key. See key setup, or use the shortcut:
runway local key setup
Deploy Docker (or rather OCI) images at ease!
We published an example repository on our Github organization:
git clone https://github.com/hostwithquantum/runway-example-docker && cd runway-example-docker
runway app create
runway app deploy
Run runway app open to see it live, or check the Runway UI. Check runway app logs if something’s off.
If you already have a Docker image, for example built by your own CI pipeline, you can deploy it directly to Runway. Create the app first:
runway app create --app=myapp
Runway reads the exposed port and user from the image metadata, so your Dockerfile must follow standard conventions:
EXPOSE <port>: the port your app listens onUSER <numeric-uid>: run as a numeric non-root user (e.g. 65534)If your image is in a private registry, register the credentials and associate them with the app before deploying:
runway registry add https://registry.example.com myuser
runway app registry set https://registry.example.com --app=myapp
runway app deploy image registry.example.com/myapp:v1.2.3 --app=myapp
Run runway app open to see it live, or check the Runway UI. Check runway app logs if something’s off.
To revert to Runway’s managed registry: runway app registry reset --app=myapp
Further examples of using the Docker pipeline include the following. While writing a Dockerfile may come with its own pitfalls, they are compatible to your own setup on localhost and they will showcase Runway’s flexibility when it comes to deploying and running all kinds of apps!