registry

Container registry commands let you store credentials for private registries and associate them with apps that deploy via runway app deploy image.

By default, Runway manages a registry for each app — runway app registry reset restores this default at any time.

registry ls

List all registries:

runway registry ls

registry add

Add a registry (or update its credentials if it already exists):

runway registry add https://registry.example.com myuser

The password is prompted interactively. To pass it non-interactively:

runway registry add https://registry.example.com myuser -p mypassword

To read the password from stdin (useful in scripts and CI pipelines):

echo "mypassword" | runway registry add https://registry.example.com myuser --password-stdin

The URL can include a path to scope credentials to a sub-path of the registry host (e.g. https://registry.example.com/myorg).

registry rm

Remove a registry:

runway registry rm https://registry.example.com

app registry set

Associate a registry with a specific app:

runway app registry set https://registry.example.com --app=myapp

Runway will use the stored credentials for this registry when pulling images for the app.

app registry reset

Reset the app back to Runway’s managed (default) registry:

runway app registry reset --app=myapp