Port the MakerWorks Next.js server listens on

Ziel

3000

Standard

3000

Wert

3000

Persistent directory for uploaded models, covers, and avatars

Ziel

/app/storage

Standard

/mnt/user/makerworks/storage

Wert

/mnt/user/makerworks/storage

Persistent backup destination (set BACKUP_DIR to this container path)

Ziel

/app/backups

Standard

/mnt/user/makerworks/storage/backups

Wert

/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.

Ziel

/app/imports

Standard

/mnt/user/makerworks/imports

Wert

/mnt/user/makerworks/imports

Postgres connection string (must be reachable from the container)

Standard

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

Wert

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

Redis connection string used for BullMQ processing queues

Standard

redis://makerworks-redis:6379

Wert

redis://makerworks-redis:6379

Public URL users access (used for redirects/cookies)

Standard

https://makerworks.example.com

Wert

https://makerworks.example.com

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

Email for the bootstrap administrator account

Standard

admin@example.com

Wert

admin@example.com

Password for the bootstrap administrator (rotated on change)

Display name for the bootstrap administrator account

Standard

Admin

Wert

Admin

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

Standard

/app/storage

Wert

/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

Standard

/app/imports

Wert

/app/imports

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

Standard

http://127.0.0.1:3000

Wert

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

Standard

true

Wert

true

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

Standard

1

Wert

1

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

Standard

/app/backups

Wert

/app/backups

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

Standard

/usr/bin/pg_dump

Wert

/usr/bin/pg_dump

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

Standard

/usr/bin/psql

Wert

/usr/bin/psql

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

Standard

db

Wert

db

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

Standard

1

Wert

1

Daily backup time in UTC (HH:mm)

Standard

03:00

Wert

03:00

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

Standard

0

Wert

0

Prune old backups immediately after each successful backup

Standard

1

Wert

1

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

Standard

14

Wert

14

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

Standard

30

Wert

30

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

Standard

5

Wert

5

Exponential backoff delay (ms) between queue retries

Standard

5000

Wert

5000

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

Standard

1

Wert

1

Concurrency for image processing inside this container

Standard

2

Wert

2

Concurrency for preview processing inside this container

Standard

1

Wert

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)

Standard

BAMBU_X1C

Wert

BAMBU_X1C

Electricity rate (per kWh) used for energy estimates

Standard

0.14

Wert

0.14

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

Standard

25.00

Wert

25.00

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

Standard

28.00

Wert

28.00

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

Standard

25.00

Wert

25.00

Expose PETG per-kg cost to the client

Standard

28.00

Wert

28.00

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

Standard

0.05

Wert

0.05

Expose the color surcharge rate to the client UI

Standard

0.05

Wert

0.05

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

Standard

4

Wert

4

Back-end currency (USD or CAD)

Standard

USD

Wert

USD

Client-facing currency label (must match CURRENCY)

Standard

USD

Wert

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

Standard

14

Wert

14

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

Standard

0

Wert

0

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

Standard

http://PrintLab:8080

Wert

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

Standard

X-API-Key

Wert

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

Standard

http://StockWorks:8000

Wert

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

Standard

info@makerworks.app

Wert

info@makerworks.app

Display name shown across the storefront and emails

Standard

MakerWorks

Wert

MakerWorks

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

Standard

v2

Wert

v2

Label used for the pickup location in checkout copy

Standard

MakerWorks lab

Wert

MakerWorks lab

Default handle placeholder for social profile fields

Standard

@makerworks

Wert

@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

Standard

MakerWorks Receipts <receipts@makerworks.app>

Wert

MakerWorks Receipts <receipts@makerworks.app>

Reply-to address for outgoing emails

Standard

MakerWorks <info@makerworks.app>

Wert

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)