Skip to content

App Deployments (5): document catalog examples (strfry / route96 / Blossom)#224

Merged
v0l merged 3 commits into
masterfrom
feat/app-deployments-seed
Jul 24, 2026
Merged

App Deployments (5): document catalog examples (strfry / route96 / Blossom)#224
v0l merged 3 commits into
masterfrom
feat/app-deployments-seed

Conversation

@v0l

@v0l v0l commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Final increment of the managed App Deployments epic. Instead of auto-seeding apps into the DB (pricing + enabling are operator decisions), this ships a reference doc with ready-to-paste, docs-accurate compose definitions.

docs/managed-app-examples.md

  • strfry — community dockurr/strfry (no official image); config at /etc/strfry.conf (bind = 0.0.0.0); data under /app/strfry-db.
  • route96 + MariaDBvoidic/route96; YAML config at /app/config.yaml; DB reached via the in-namespace service db; per route96's config.prod.yaml.
  • Blossomghcr.io/hzrd149/blossom-server; YAML config at /app/config.yml; bare publicDomain; SQLite + blobs under /app/data.
  • How to add via POST /api/admin/v1/apps + the compose-grammar recap.
  • Notes on why HAVEN (needs a mounted templates/ dir of binary assets + JSON lists) and zap-stream (needs expose: tcp/udp) aren't cleanly deployable yet.

Removes the earlier app_seeds module + demo-data wiring.

v0l added 2 commits July 24, 2026 18:29
Final MVP increment of the App Deployments epic. Ships validated compose
definitions for the launch catalog.

- lnvps_api_admin::app_seeds: strfry, HAVEN, route96 (+MariaDB, generated
  secrets + backups), and a generic Blossom server. Each is a validated
  lnvps_compose document exercising the grammar (ports/ingress, files,
  volumes, secrets, resources).
- seed_launch_apps(db): idempotently inserts any missing apps DISABLED
  (operator reviews/prices before offering) with the footprint computed
  from the compose. Wired into generate_demo_data.
- Tests: every launch compose parses + has a non-zero footprint; seeding is
  idempotent (MockDb).

Part of work/app-deployments.md (MVP increments 1-5 complete; backups and
L4/zap-stream remain as future increments).
Read each project's actual docs and fixed the images/config:
- strfry: community dockurr/strfry (no official image); config at
  /etc/strfry.conf with bind 0.0.0.0; db under /app/strfry-db.
- route96: voidic/route96 (not ghcr) + MariaDB reached via service 'db';
  config is a YAML file at /app/config.yaml (listen/database/storage_dir/
  public_url), matching route96's config.prod.yaml + docker-compose.
- blossom: ghcr.io/hzrd149/blossom-server; YAML config at /app/config.yml;
  publicDomain is a bare hostname; SQLite + blobs under /app/data.

Dropped HAVEN: no official image, and the community haven-docker image
requires a mounted templates/ directory of binary web assets + 4 JSON
files, which the ConfigMap-file model can't provide cleanly. Deferred.
@v0l

v0l commented Jul 24, 2026

Copy link
Copy Markdown
Contributor Author

Corrected the launch composes after actually reading each project's deploy docs:

  • strfry → community dockurr/strfry (no official image); config at /etc/strfry.conf with bind = 0.0.0.0; data under /app/strfry-db.
  • route96voidic/route96 (Docker Hub, not ghcr) + MariaDB reached via the in-namespace service db; config is a YAML file at /app/config.yaml (listen/database/storage_dir/public_url), per route96's config.prod.yaml + docker-compose.prod.yml.
  • blossomghcr.io/hzrd149/blossom-server; YAML config at /app/config.yml; publicDomain is a bare hostname; SQLite + blobs under /app/data.
  • HAVEN dropped: no official image, and the community holgerhatgarkeinenode/haven-docker image requires a mounted templates/ directory of binary web assets (favicons, etc.) + 4 JSON files — the ConfigMap-file model can't provide that cleanly. Deferred until a self-contained image exists (or we build one).

Seeding apps into the DB is the wrong fit — pricing and enabling are
operator decisions. Remove the app_seeds module + demo-data wiring and
instead provide docs/managed-app-examples.md: ready-to-paste, docs-accurate
compose definitions (strfry via dockurr/strfry, route96 + MariaDB via
voidic/route96, Blossom via ghcr.io/hzrd149/blossom-server) with how to add
them through POST /api/admin/v1/apps, plus notes on HAVEN/zap-stream not
being cleanly deployable yet.
@v0l v0l changed the title App Deployments (5): seed Nostr-native launch apps App Deployments (5): document catalog examples (strfry / route96 / Blossom) Jul 24, 2026
@v0l
v0l merged commit ea84818 into master Jul 24, 2026
8 checks passed
@v0l
v0l deleted the feat/app-deployments-seed branch July 24, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant