Templates deploy ready-made software (databases, caches, search engines) to a Runway app. You can also deploy templates from your browser.
List all templates:
runway template ls
--min-plan only lists the templates that suggest the given plan:
runway template ls --min-plan=free-launch
Show the details of one template:
runway template show mariadb
The output contains the description, the available versions and the plan the template suggests.
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.
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.
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
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.