Skip to content

Releases

v1.0.0

Choose a tag to compare

@bauerpawel bauerpawel released this 11 Aug 08:18

Dockyard v1.0.0 — First Release 🚢

The first public release of Dockyard — a Portainer app template feed (v3 format) plus a browsable gallery website to help you find them.

What's included

  • 612 app templates for Portainer (v3 format), generated from a single source of truth — one YAML file per app under apps/.
  • templates.json — a ready-to-use feed you can paste into Portainer (Settings → App Templates → URL), served through the jsDelivr CDN for faster, more reliable loading worldwide.
  • The Dockyard website (docs/, hosted on GitHub Pages at bauerpawel.github.io/DOCKYARD/) — cards with logo, description, category and links, with search and category filtering.
  • A Python CLI (python -m gallery ...) for building the feed and site, fetching Docker Hub metadata, validating against Portainer's v3 schema, and scaffolding new apps (gallery new).
  • Support for compose-type apps — ready-made stacks (WordPress, Nextcloud, Gitea, Grafana+Prometheus, n8n, Ghost) pairing an app with its database.
  • Two automated GitHub Actions workflows:
    • build.yml — rebuilds the feed and site on every push to main (plus a weekly Saturday safety-net run) and purges the jsDelivr cache.
    • refresh-dockerhub.yml — refreshes Docker Hub metadata (descriptions, etc.) monthly.
  • A test suite (pytest) and templates.json validation against the official Portainer v3 schema.
  • MIT license.

Getting started

  1. In Portainer: Settings → App Templates.
  2. Paste in the feed URL:
    https://cdn.jsdelivr.net/gh/bauerpawel/DOCKYARD@main/templates.json
    
  3. Save — all 612 one-click apps will show up immediately in App Templates.

Requires a Portainer version that supports v3 app templates.

You can also browse the gallery directly at: https://bauerpawel.github.io/DOCKYARD/

Known limitations

  • Freshness of Docker Hub descriptions depends on the monthly refresh cycle (refresh-dockerhub.yml) — a newly added app will only show its auto-fetched description after the next refresh, unless a description is set manually in the YAML.
  • This is currently a solo project (no outside contributors yet) — bug reports and PRs are welcome.