Port the MakerWorks Next.js server listens on

Target

3000

Default

3000

Value

3000

Persistent directory for uploaded models, covers, and avatars

Target

/app/storage

Default

/mnt/user/makerworks/storage

Value

/mnt/user/makerworks/storage

Persistent backup destination (set BACKUP_DIR to this container path)

Target

/app/backups

Default

/mnt/user/makerworks/storage/backups

Value

/mnt/user/makerworks/storage/backups

Optional mapped folder used by the bulk upload script. Put source STL/OBJ/3MF/AMF/PLY/WRL/VRML/GLB/GLTF/USD/USDZ/USDA/USDC/ZIP files here and run the importer against /app/imports.

Target

/app/imports

Default

/mnt/user/makerworks/imports

Value

/mnt/user/makerworks/imports

Postgres connection string (must be reachable from the container)

Default

postgresql://postgres:postgres@postgres:5432/makerworks?schema=public

Value

postgresql://postgres:postgres@postgres:5432/makerworks?schema=public

Redis connection string used for BullMQ processing queues

Default

redis://makerworks-redis:6379

Value

redis://makerworks-redis:6379

Public URL users access (used for redirects/cookies)

Default

https://makerworks.example.com

Value

https://makerworks.example.com

Secret used to sign user sessions (set to a long random string)

Email for the bootstrap administrator account

Default

admin@example.com

Value

admin@example.com

Password for the bootstrap administrator (rotated on change)

Display name for the bootstrap administrator account

Default

Admin

Value

Admin

Internal storage path (leave at /app/storage unless customizing)

Default

/app/storage

Value

/app/storage

Optional direct hostname (e.g., https://upload.example.com) used only for uploads to bypass Cloudflare/Tunnel size limits

Default in-container folder scanned by the bulk upload importer

Default

/app/imports

Value

/app/imports

URL used by the bulk upload importer when run inside the container. Leave at http://127.0.0.1:3000 for Unraid.

Default

http://127.0.0.1:3000

Value

http://127.0.0.1:3000

Optional S3 bucket (leave blank to store uploads locally on STORAGE_DIR)

Region/endpoint for the S3 bucket (e.g., us-east-1)

Access key for the configured S3-compatible storage

Secret key for the configured S3-compatible storage

Set to true when BASE_URL is HTTPS so auth cookies are secure

Default

true

Value

true

Set to 1 on Unraid/non-compose runtimes so backups/restores use local client tools instead of docker compose exec

Default

1

Value

1

Backup destination inside the container. Must point to a mapped path (recommended: /app/backups).

Default

/app/backups

Value

/app/backups

Path to pg_dump binary used by backup when SKIP_DOCKER=1 (or docker compose path fails)

Default

/usr/bin/pg_dump

Value

/usr/bin/pg_dump

Path to psql binary used by restore when SKIP_DOCKER=1 (or docker compose path fails)

Default

/usr/bin/psql

Value

/usr/bin/psql

Docker Compose DB service name used for pg_dump/psql when compose mode is enabled

Default

db

Value

db

Enable daily scheduled backups (1=true, 0=false)

Default

1

Value

1

Daily backup time in UTC (HH:mm)

Default

03:00

Value

03:00

Run one backup when scheduler starts (1=true, 0=false)

Default

0

Value

0

Prune old backups immediately after each successful backup

Default

1

Value

1

Keep backups newer than this many days (0 disables age-based retention)

Default

14

Value

14

Always keep at least this many newest backups (0 disables count-based retention)

Default

30

Value

30

Queue retry attempts before moving a failed job to dead-letter handling

Default

5

Value

5

Exponential backoff delay (ms) between queue retries

Default

5000

Value

5000

Run the image/preview processor inside this MakerWorks container so it uses the same DATABASE_URL and STORAGE_DIR settings

Default

1

Value

1

Concurrency for image processing inside this container

Default

2

Value

2

Concurrency for preview processing inside this container

Default

1

Value

1

Printer preset for speed/energy math (BAMBU_X1C, BAMBU_P1S, PRUSA_MK4, PRUSA_MK3S, CREALITY_K1_MAX, CREALITY_ENDER3_V2, ANYCUBIC_KOBRA2, GENERIC_FDM)

Default

BAMBU_X1C

Value

BAMBU_X1C

Electricity rate (per kWh) used for energy estimates

Default

0.14

Value

0.14

Price of a 1kg PLA spool (USD) used for estimator

Default

25.00

Value

25.00

Price of a 1kg PETG spool (USD) used for estimator

Default

28.00

Value

28.00

Expose PLA per-kg cost to the client (used for cart price previews)

Default

25.00

Value

25.00

Expose PETG per-kg cost to the client

Default

28.00

Value

28.00

Extra cost rate per additional color beyond the first (server-side)

Default

0.05

Value

0.05

Expose the color surcharge rate to the client UI

Default

0.05

Value

0.05

How many color slots the cart exposes (raise to 8+ if you have multiple AMS units)

Default

4

Value

4

Back-end currency (USD or CAD)

Default

USD

Value

USD

Client-facing currency label (must match CURRENCY)

Default

USD

Value

USD

Optional CAD override for PLA per-kg cost

Optional CAD override for PETG per-kg cost

Optional CAD override for energy rate per hour

Optional CAD minimum price override

Extra hourly surcharge after first hour (USD context)

Extra hourly surcharge after first hour (CAD context)

Stripe secret key (starts with sk_live_ or sk_test_)

Stripe publishable key used by the in-app checkout UI

Stripe webhook signing secret for /api/stripe/webhook

Stripe shipping rate ID required when shipped checkout is enabled

Days until due for Stripe invoices sent from invoice checkout

Default

14

Value

14

Set to 1 after Stripe Tax registrations and product tax settings are configured

Default

0

Value

0

Internal PrintLab URL reachable from the MakerWorks container on the shared Docker network

Default

http://PrintLab:8080

Value

http://PrintLab:8080

Optional Authorization header for MakerWorks-to-PrintLab admin API calls, for example a Basic or Bearer value

Optional PrintLab session cookie for MakerWorks-to-PrintLab admin API calls

Optional PrintLab API key for MakerWorks-to-PrintLab API calls when PrintLab is configured to accept one

Header name used with PRINTLAB_API_KEY

Default

X-API-Key

Value

X-API-Key

Shared secret MakerWorks expects for inbound job updates to /api/makerworks/jobs (send via Authorization Bearer token or MakerWorks signature header)

Shared secret expected on PrintLab callbacks into MakerWorks

Internal StockWorks URL reachable from the MakerWorks container on the shared Docker network

Default

http://StockWorks:8000

Value

http://StockWorks:8000

Optional StockWorks admin username for MakerWorks-to-StockWorks inventory checks

Optional StockWorks admin password for MakerWorks-to-StockWorks inventory checks

Optional StockWorks username fallback

Optional StockWorks password fallback

Optional JSON color override map for StockWorks filament availability

Optional seasonal theme: christmas, halloween, easter, valentines, or maythefourth

Contact email shown on the site

Default

info@makerworks.app

Value

info@makerworks.app

Display name shown across the storefront and emails

Default

MakerWorks

Value

MakerWorks

Optional suffix shown next to the logo (leave blank to hide)

Default

v2

Value

v2

Label used for the pickup location in checkout copy

Default

MakerWorks lab

Value

MakerWorks lab

Default handle placeholder for social profile fields

Default

@makerworks

Value

@makerworks

SMTP host for verification emails

SMTP port

SMTP username

SMTP password

Use TLS/SSL (true/false) depending on your SMTP provider

From address for verification/receipt emails

Default

MakerWorks Receipts <receipts@makerworks.app>

Value

MakerWorks Receipts <receipts@makerworks.app>

Reply-to address for outgoing emails

Default

MakerWorks <info@makerworks.app>

Value

MakerWorks <info@makerworks.app>

Optional bot token used for Discord announcements

Discord channel ID used for announcements

Bot token used for admin notifications (falls back to DISCORD_BOT_TOKEN when unset)

Discord channel ID for admin-only alerts (new users/uploads)