name: metatransportnzb

# One of MetaShare's transport plugins (meta-transport-nzb). MetaShare (the
# hull) reaches it at http://metashare-nzb:3000 over `pcs` — the default entry
# in its plugin list — and probes it every 10 s, so installing or removing this
# app takes effect with no other step. Manage it from MetaShare → Plugins.
#
# It shares MetaShare's data volume (same /data layout the monolith used: the
# `tmp/` → `cache/` promote is one rename(2), and the hull reads plugin-written
# files directly). Its own settings live in its state dir (config.json), edited
# through MetaShare's dashboard.
#
# A headless service: no tile link, no Caddy route, no AppShield. Its config
# page is reached only through MetaShare (Plugins → configure, proxied by
# /api/plugins/<name>/ui/*), behind MetaShare's own perimeter.

services:
  metashare-nzb:
    image: ghcr.io/worph/meta-transport-nzb:1.1.0
    container_name: metashare-nzb
    hostname: metashare-nzb
    restart: unless-stopped
    cpu_shares: 20
    # Hard RAM cap, swap disabled (memswap_limit == mem_limit) → OOM instead of swap.
    mem_limit: 3g
    memswap_limit: 3g
    # Clean redb / session shutdown on SIGTERM before docker escalates.
    stop_grace_period: 30s
    # Root, like MetaShare: the shared data volume is root-owned.
    user: 0:0
    expose:
      - 3000   # transport contract (internal, reached by MetaShare only)
    volumes:
      - ${DATA_ROOT:-/DATA}/AppData/metashare/data:/data:rw
      - ${DATA_ROOT:-/DATA}/AppData/metatransportnzb/state:/state:rw
    environment:
      - META_SHARE_HULL_URL=http://metashare-app:3001
      - TZ=$TZ
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost:3000/health"]
      interval: 10s
      timeout: 3s
      retries: 10
      start_period: 30s
    networks:
      - pcs

networks:
  pcs:
    name: ${APP_NET:-pcs}
    external: true

x-casaos:
  architectures:
    - amd64
    - arm64
  author: Worph Team
  category: Media
  tags: ["media"]
  developer: Aptero Team

  description:
    en_us: |
      **Usenet (NZB) transport for MetaShare.**

      Streams Usenet releases progressively over **your NNTP provider** (yEnc,
      par2 repair, RAR sets), so playback starts before the download ends.

      **One of MetaShare's transport plugins.** Configure your provider from
      **MetaShare → Plugins → nzb → configure** (host, port, user, password,
      connections). Without a provider it stays installed but idle, and MetaShare
      forwards Usenet requests to a gateway on the mesh instead. An existing
      MetaShare's provider settings are imported automatically on first start.

      **Requires:** **MetaShare** (it shares MetaShare's storage). Usenet is
      fetch-only: this plugin does not seed. Uses up to ~3 GB RAM while a
      release downloads.

    fr_fr: |
      **Transport Usenet (NZB) pour MetaShare.**

      Lit les releases Usenet progressivement via **votre fournisseur NNTP** (yEnc,
      réparation par2, archives RAR).

      **Un des plugins de transport de MetaShare.** Le fournisseur se configure dans
      **MetaShare → Plugins → nzb → configure**. Les réglages d'un MetaShare existant
      sont importés au premier démarrage.

      **Nécessite :** **MetaShare**. Jusqu'à ~3 Go de RAM pendant un téléchargement.

  tagline:
    en_us: Usenet for MetaShare — stream NZB releases from your provider
    fr_fr: Usenet pour MetaShare — lecture des releases NZB depuis votre fournisseur

  title:
    en_us: MetaTransport · Usenet

  icon: https://cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/Apps/MetaTransportNzb/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/Apps/MetaTransportNzb/thumbnail.png

  store_app_id: metatransportnzb
  is_uncontrolled: false

  tips:
    before_install:
      en_us: |
        **Install MetaShare first** — this plugin shares its storage and is
        driven by it. MetaShare picks it up automatically within ~10 s; check
        **MetaShare → Plugins**, where it shows as *live*.

        Settings: **MetaShare → Plugins → nzb → configure**. Saving restarts the plugin to apply.

# Maison (Yundera dashboard) configuration. Read in preference to x-casaos.
x-compose-app:
  schema_version: 2
  folders:
    - path: /DATA/AppData/metatransportnzb/state
      user: $PUID
      group: $PGID
  # An extension of MetaShare: no tile of its own, nested under MetaShare's,
  # and listed in the store under MetaShare's Extensions. Presentation only —
  # lifecycle and backups stay per-app.
  parent: metashare