app: id: podsteadr-blossom name: podsteadr Blossom version: "6.4.1" description: Blossom (BUD-02) sha256-addressed media blob server backing podsteadr's episode uploads and covers. category: media # Hyphenated name matches the podsteadr repo's docker-compose container_name # (podsteadr-blossom); alias `blossom` is the short hostname podsteadr's # server reaches it by (BLOSSOM_URL_INTERNAL=http://blossom:3000). container_name: podsteadr-blossom container: # 6.x (Deno rewrite) serves HTTP Range requests natively — 4.x streamed # every blob chunked with no Content-Length, breaking seeking and # iOS/Apple Podcasts playback. Starts with no egress (verified with # --network none). Upgrading a node that ran 4.x: 6.x migrates the # sqlite.db in place on first start (backup at data/sqlite.db.bak), then # run the podsteadr repo's scripts/fix-blossom-sizes.py against # data/ with this app stopped — 4.4.1 sometimes stored wrong blob sizes, # which 6.x serves as Content-Length. image: ghcr.io/hzrd149/blossom-server:6.4.1 pull_policy: if-not-present network: podsteadr-net network_aliases: [blossom] # Image runs as container-root (no USER directive). Leave data_uid unset: # fresh bind directories inherit the rootless service user's ownership. # Explicit "0:0" is host root in the ownership helper, not container root. dependencies: - storage: 20Gi resources: cpu_limit: 1 memory_limit: 512Mi disk_limit: 20Gi security: capabilities: [CHOWN, DAC_OVERRIDE, FOWNER] readonly_root: false no_new_privileges: true network_policy: isolated ports: - host: 8098 container: 3000 protocol: tcp auth: none auth_rationale: >- Media blobs (episode audio/video, covers) must be publicly fetchable by podcast clients as RSS enclosure URLs — that's the entire purpose of this port. Uploads and deletes are separately gated by blossom's own BUD-02 signed-nostr-event auth (upload/delete.requireAuth below), not a node session; reads are intentionally public per the config's own header comment. # Declared so the catalog generator adds 8098 to the fips0 firewall # allowance: feeds fetched over the mesh (http://.fips:8095) point # their enclosures at http://.fips:8098/, and mesh-only # podcast clients (and other nodes' podsteadr-player gateways) must be # able to fetch them. interfaces: main: name: Blossom media description: BUD-02 blob reads (episode audio/video, cover art) for RSS enclosures type: api port: 8098 protocol: http path: / volumes: - type: bind source: /var/lib/archipelago/podsteadr-blossom/data target: /app/data options: [rw] - type: bind source: /var/lib/archipelago/podsteadr-blossom/config/config.yml target: /app/config.yml options: [ro] environment: # Refuse to boot if config.yml is missing/invalid — 6.x's schema defaults # prune video after a week. - BLOSSOM_REQUIRE_CONFIG=1 # Same file as blossom/config.yml in the podsteadr repo. files: - path: /var/lib/archipelago/podsteadr-blossom/config/config.yml overwrite: true content: | # blossom-server (v6.x) configuration for podsteadr. # Uploads require a signed nostr auth event (BUD-02, kind 24242); # reads are public so podcast apps can fetch enclosures. # # Compose sets BLOSSOM_REQUIRE_CONFIG=1: without this file v6 would boot on # its schema defaults, whose rules prune video after 1 week of no access. # Empty = use the request's Host header (podsteadr is reached by several # hostnames: the raw IP, a domain behind nginx/Cloudflare, Tailscale). publicDomain: "" database: path: data/sqlite.db storage: backend: local local: dir: ./data/blobs removeWhenNoOwners: false # Rules are both the upload allowlist (unmatched MIME types get 415) and # the prune policy: a blob is deleted once it goes unaccessed for longer # than `expiration`. v6 has no "never", so podcast media gets 100 years. rules: - type: "*" expiration: 100 years upload: enabled: true requireAuth: true requirePubkeyInRule: false maxSize: 2147483648 # 2 GB — matches the upload wizard's cap delete: requireAuth: true # Not used by podsteadr — kept off to minimise surface (mirror makes the # server fetch arbitrary URLs; media runs ffmpeg/sharp on uploads). mirror: enabled: false media: enabled: false requirePubkeyInRule: true # explicit, or v6 warns at startup list: enabled: false landing: enabled: false dashboard: enabled: false report: enabled: false health_check: # No documented health endpoint; TCP liveness on the app port. type: tcp endpoint: localhost:3000 interval: 30s timeout: 5s retries: 3