yoink add and the bundled templates
The sequence that yoink add runs for a template, and the list of templates that ship with yoink.
What yoink add does
- Fetches
templates/<name>/fromoddur/yoink@main, or from a different repo.--from-pathreads a local directory. - Reads the
template.yamlmanifest of the template. - Prompts for each variable that has no
--varvalue.--yesuses every default. - Renders the files with minijinja.
- Shows the planned changes and asks
Proceed?. Then writes the files. - Generates the declared secrets and seals them into your
secrets.age. The random bytes never leave the local process. - Adds the fragment glob to the
include:list of youryoink.yaml, if the list does not already cover it. - Prints the
connectionblock and the notes of the manifest. They tell you how to connect the service to your app. - Asks
Deploy now?.--updeploys without the question.
--yes skips the prompts and is required in CI.
Bundled templates
| Template | Kind | What you get |
|---|---|---|
postgres |
accessory | Postgres 18, a named volume, and a sealed <NAME>_PASSWORD. Opt-in WAL archiving for PITR. |
redis |
accessory | Redis 7 with secure-by-default config. |
meilisearch |
accessory | Meilisearch, a volume, and a sealed master key. |
rustfs |
accessory | Apache-2.0 S3-compatible object storage with sealed root credentials. |
restic-backups |
accessory | Nightly volume snapshots through resticker (restic + go-cron) to any S3-compatible bucket. |
openclaw |
app | Placeholder app template. Rename it and point image: at your image. |
The full set is at https://github.com/oddur/yoink/tree/main/templates.
See also
- Adding a service via
yoink add: the commands for bundled, pinned and third-party templates. - Authoring templates: the manifest, minijinja rendering, and secrets sealing.
- CLI reference: the flags of
yoink add.