1 Workers
Forgejo Actions edited this page 2026-09-25 17:00:22 +00:00

Workers

Five worker services handle background processing, each granted a specific capability set by Core:

  • worker-media — metadata extraction, thumbnails, previews, plant and discovery thumbnails, and video previews.
  • worker-ml — semantic embeddings, visual concept detection, test image labels, and album-shape proposal training and scoring.
  • worker-plants — plant detection, plant identification, and model download.
  • worker-people — people discovery, owner face recognition, and owner face embedding backfill.
  • worker-converter — model conversion.

Workers authenticate with scoped, revocable tokens plus a shared secret. They claim leased jobs over the Core-owned worker-protocol-v1 protocol, submit idempotent candidate results, and receive only read-only stored-objects mounts. They wait for the API healthcheck, back off on startup failures, and handle termination signals cleanly: compose sets SIGINT with a 10-second stop grace period (30 seconds for the converter), so docker compose down --timeout 10 should not hang.

One operational gotcha: long jobs currently lack heartbeats against the roughly five-minute lease reaper, so a job can be requeued while the first worker is still running, producing duplicate results or artifacts. This is tracked as ISSUE-020 in Known Issues and Operator Diagnostics.

Details