daniel/furtka-apps
1
1
Fork 0
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions
No description
11 commits 1 branch 7 tags 78 KiB
Find a file
Daniel Maksymilian Syrnicki b1dadbc952
All checks were successful
CI / validate (push) Successful in 5s
Details
CI / shellcheck (push) Successful in 13s
Details
Release / release (push) Successful in 5s
Details
chore: release 26.11-alpha 
Catalog 26.11-alpha rolls up the Jellyfin compose default-substitution
fix (already on main as 2a31a79) into a tagged release so the
validator CI goes green on every post-Jellyfin commit.

No app additions or schema changes — core 26.11-alpha (auth) is the
substantive release this cycle, catalog just clears its CI red X.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-21 13:01:55 +02:00
.forgejo/workflows chore: bootstrap furtka-apps catalog repo 2026-04-20 14:14:50 +02:00
apps fix(jellyfin): use compose default-substitution so validator passes 2026-04-21 12:18:57 +02:00
scripts feat(jellyfin): add media-server app using new path-type setting 2026-04-21 11:40:29 +02:00
.gitignore chore: bootstrap furtka-apps catalog repo 2026-04-20 14:14:50 +02:00
CHANGELOG.md chore: release 26.11-alpha 2026-04-21 13:01:55 +02:00
README.md chore: bootstrap furtka-apps catalog repo 2026-04-20 14:14:50 +02:00

README.md

furtka-apps

Apps catalog for Furtka. Each release here ships a tarball that running Furtka boxes pull via the daily catalog-sync timer (see furtka.catalog in the core repo). Apps update on their own cadence, independent of Furtka's core OS release schedule.

Repo layout

apps/                  # one folder per app
  <name>/
    manifest.json      # JSON schema — see ./apps/README.md
    docker-compose.yaml
    .env.example       # if the app has user-facing settings
    icon.svg
scripts/
  build-catalog-tarball.sh    # bundle apps/ + VERSION into furtka-apps-<ver>.tar.gz
  publish-catalog-release.sh  # upload tarball + sha256 + release.json to Forgejo
  validate-catalog.py         # CI guardrail — manifest + compose syntax
  vendor/
    furtka_manifest.py        # copy of daniel/furtka furtka/manifest.py
.forgejo/workflows/
  ci.yml             # JSON + manifest + shellcheck on every push/PR
  release.yml        # tag push → build tarball → publish to Forgejo releases

Adding an app

See apps/README.md for the manifest schema, volume namespacing rules, .env.example guardrails, and the SVG sanitiser limits the Furtka UI enforces on icon.svg.

Shape of a new app PR:

  1. Add apps/<name>/ with all four files.
  2. python3 scripts/validate-catalog.py locally — must go green.
  3. Open a PR. CI runs the same validator + shellcheck.
  4. Merged to main — next catalog release will include it.

Cutting a release

Follows the same CalVer + tag-driven pattern as daniel/furtka:

# Bump CHANGELOG.md [Unreleased] → [<version>] section, commit:
git commit -m "chore: release <version>"
git tag -a <version> -m "Release <version>"
git push origin main
git push origin <version>

Tag push fires .forgejo/workflows/release.yml. Needs FORGEJO_RELEASE_TOKEN secret (PAT with write:repository on this repo).

Trust model

Releases are unsigned (SHA256 sidecar only). Boxes verify the sidecar against the downloaded tarball before extracting anything. Same posture as daniel/furtka core releases — PGP is a deferred cross-repo migration.

Relationship to daniel/furtka

  • The core repo still ships apps/fileshare/ as a seed inside the Furtka release tarball. That's the offline/first-boot fallback.
  • When a box has synced the catalog at least once, the resolver (furtka.sources.resolve_app_name) prefers the catalog copy.
  • Already-installed apps don't auto-reinstall on catalog updates — user hits "Reinstall" in /apps when they want the new version. Settings are merge-preserved.