Runway
Runway is built and operated in the EU!

templates

Templates deploy ready-made software (databases, caches, search engines) to a Runway app. You can also deploy templates from your browser.

template ls

List all templates:

runway template ls

--min-plan only lists the templates that suggest the given plan:

runway template ls --min-plan=free-launch

template show

Show the details of one template:

runway template show mariadb

The output contains the description, the available versions and the plan the template suggests.

app deploy template

Create an app, then deploy the template to it:

runway app create --app=my-db --plan=start-m-launch
runway app deploy template --app=my-db --template=mariadb

This deploys the latest version of the template.

inputs

Some templates have inputs, for example the name of the database to create. Pass them as key=value after the flags:

runway app deploy template --app=my-db --template=mariadb \
  database_name=shop username=shop

An input you leave out gets the default from the template. Check the docs for the specific template for a list of available options.

connection details

runway app show --app=my-db

For an app deployed from a template, this shows the template name and version, the internal address, and a DSN or URL to connect with.

Passwords in the DSN or URL are replaced by the name of the config value that holds them, for example <MARIADB_PASSWORD>. To print the full value:

Template apps are reachable within Runway, from your other Runway apps (only from your apps).

runway app show --app=my-db --reveal

updates

runway app ls and runway app show tell you when a newer version of the template is available.

To update, deploy the template again, with the same inputs as before:

runway app deploy template --app=my-db --template=mariadb\
  database_name=shop username=shop

Passwords that were generated on the first deployment stay the same. Config values you set yourself with runway app config set stay as well.