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
Memories Wiki
Using Memories
- Accounts, the Library Hub, and Data Export
- Albums and Automatic Suggestions
- Explore and Discovery Domains
- The Media Viewer
- People and Faces
- Places and Map
- Plants (In Development)
- Datenschutzerklärung (Privacy Policy)
- Fast, Progressive Image Loading
- Search
- Sharing and Households
- Timeline and Photos
- Uploading and Import
Self-Hosting
- Backup and Restore
- CLI Password Reset
- Deployment Architecture
- Known Issues and Operator Diagnostics
- Map Tiles and Place Data Privacy
- Storage Layout
- Upgrades and Versioning
- Workers
Reference