How the registry works
Each template lives in templates/<id>/ in
the GitHub repository. On every merge to main, CI generates registry.json, which is
currently at v1.35.0 with 132
templates.
Use it in Arcane
- Open Settings → Templates in Arcane.
- Add
https://registry.getarcane.app/registry.jsonas a registry. - Pick a template, fill in its environment values, and deploy.
Template files
- compose.yaml
- The Compose project. Images track :latest, except databases pinned to a major version.
- .env.example
- Every variable the compose file uses without a default. Secrets are placeholders.
- template.json
- Name, description, author, icon_url and tags. version is optional.
- README.md
- Deployment notes: first-run steps, paths and links to upstream docs.
Versioning
Every template carries a content_hash computed from
template.json, compose.yaml, .env.example and README.md, so Arcane can see when a template changed.
minor
New template
Adding a template directory bumps the registry's minor version.
patch
Changed or removed template
Any change to a template's files, or removing a template, bumps the registry's patch version.
patch
Template versions
If template.json leaves out version, the template's version gets a patch bump whenever its content_hash changes. A version written in template.json always wins.
Contributing
vp install vp run new my-app # scaffold templates/my-app vp run lint:templates my-app # check it, add --fix for automatic fixes
See CONTRIBUTING.md for the full checklist.
Tags
Templates use tags from this list (tags.json).
| ai | AI models, LLM runtimes and chat interfaces | 1 |
| analytics | Web and usage analytics | 3 |
| archive | Offline archives and web preservation | 2 |
| automation | Workflow automation and scheduled jobs | 14 |
| backup | Backups and snapshots | 4 |
| bookmarks | Bookmark managers and read-it-later | 4 |
| books | Ebooks, comics and audiobooks | 4 |
| calendar | Calendars and contacts (CalDAV/CardDAV) | 1 |
| dashboard | Start pages and homelab dashboards | 5 |
| database | Databases, caches and database tools | 7 |
| development | Developer tools, IDEs and API tooling | 10 |
| dns | DNS and DHCP servers | 3 |
| docker | Docker and container management | 3 |
| documents | Document management, PDF and OCR | 3 |
| downloads | Download clients (torrent, usenet) | 5 |
| Email servers and testing | 1 | |
| files | File browsing, sharing and sync | 6 |
| finance | Budgeting and personal finance | 1 |
| fitness | Fitness and activity tracking | 1 |
| games | Game servers and game libraries | 3 |
| git | Git hosting | 2 |
| hobby | Hobby and craft tracking | 1 |
| home-automation | Smart home and IoT | 2 |
| household | Inventory, groceries and recipes | 4 |
| identity | Authentication, SSO and identity providers | 2 |
| logging | Log viewers and aggregation | 1 |
| media | General media apps | 30 |
| media-management | Media library automation (the *arr apps, requests, indexers) | 11 |
| media-server | Media servers and their companions | 5 |
| monitoring | Uptime, metrics and system monitoring | 12 |
| music | Music streaming and libraries | 2 |
| networking | Tunnels, network tools and speed tests | 6 |
| notes | Note taking | 4 |
| notifications | Push notifications and messaging | 2 |
| photos | Photo libraries | 2 |
| privacy | Ad blocking and privacy tools | 3 |
| productivity | General productivity and collaboration | 20 |
| reverse-proxy | Reverse proxies and TLS | 2 |
| rss | Feed readers | 3 |
| search | Search engines | 1 |
| security | Password managers and security tools | 4 |
| storage | Object and cloud storage | 4 |
| tasks | Tasks, kanban and project management | 3 |
| tools | Small single-purpose utilities and converters | 14 |
| video | Video downloaders and YouTube front ends | 3 |
| vpn | VPN servers | 1 |
| wiki | Wikis and documentation | 3 |