MakerWorks-v2-Worker

MakerWorks-v2-Worker

Docker app from techpunk's repo

Overview

Companion background worker for MakerWorks v2. This container consumes BullMQ image and model-preview jobs queued by the MakerWorks web app. Install MakerWorks Redis before starting this worker.

Requirements

MakerWorks-v2, makerworks-postgres, makerworks-redis, matching mapped storage, and Docker network makerworks-net.

Runtime arguments

Network
makerworks-net
Shell
bash
Privileged
false
Extra Params
--restart unless-stopped --add-host=host.docker.internal:host-gateway

Template configuration

Storage PathPathrw

Persistent MakerWorks storage. Must match the MakerWorks-v2 web container mapping.

Target
/app/storage
Default
/mnt/user/appdata/makerworks/storage
Value
/mnt/user/appdata/makerworks/storage
Database URLVariable

PostgreSQL connection string. Must match MakerWorks-v2.

Target
DATABASE_URL
Default
postgresql://postgres:change-this-password@makerworks-postgres:5432/makerworks?schema=public
Value
postgresql://postgres:change-this-password@makerworks-postgres:5432/makerworks?schema=public
Redis URLVariable

Redis connection string used for BullMQ processing queues.

Target
REDIS_URL
Default
redis://makerworks-redis:6379
Value
redis://makerworks-redis:6379
Storage DirectoryVariable

Internal durable storage root.

Target
STORAGE_DIR
Default
/app/storage
Value
/app/storage
Queue AttemptsVariable

Queue retry attempts before dead-lettering.

Target
PROCESSING_QUEUE_ATTEMPTS
Default
5
Value
5
Queue Backoff MillisecondsVariable

Exponential retry backoff delay in milliseconds.

Target
PROCESSING_QUEUE_BACKOFF_MS
Default
5000
Value
5000
Image Worker ConcurrencyVariable

Parallel image-processing jobs consumed by this worker.

Target
IMAGE_WORKER_CONCURRENCY
Default
2
Value
2
Preview Worker ConcurrencyVariable

Parallel model-preview jobs consumed by this worker.

Target
PREVIEW_WORKER_CONCURRENCY
Default
1
Value
1
TimezoneVariable

Container timezone.

Target
TZ
Default
Etc/UTC
Value
Etc/UTC

Details

Repository
ghcr.io/schartrand77/mkw2:latest
Last Updated2026-05-31
First Seen2025-12-19

Run MakerWorks-v2-Worker on Unraid.

MakerWorks-v2-Worker is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.