MakerWorks-v2

MakerWorks-v2

Docker 应用程序 from schartrand77's Repository

概述

MakerWorks v2 is a self-hosted 3D model hub with STL previews, price estimation, optional Stripe checkout, and an admin dashboard for site settings, pricing, backups, and OrderWorks job monitoring. Point it at any reachable Postgres 15+ instance and map a persistent storage share for uploaded models, covers, avatars, and backups. On Unraid, this primary container also runs the image/preview processing worker by default so uploads use the same database and storage settings as the web app. Unraid note: "Autostart" starts the container when the array/Docker service starts, but crash recovery still depends on Docker restart policy. If the container stops, check its logs: the image startup sequence runs restore, Prisma migrations, admin bootstrap, then the Next.js server and integrated processing worker.

运行时参数

网络用户界面
http://[IP]:[PORT:3000]/
网络
makerworks-net
外壳
bash
特权
false

模板配置

Web PortPorttcp

Port the MakerWorks Next.js server listens on

目标
3000
默认值
3000
价值
3000
StoragePathrw

Persistent directory for uploaded models, covers, and avatars

目标
/app/storage
默认值
/mnt/user/makerworks/storage
价值
/mnt/user/makerworks/storage
BackupsPathrw

Persistent backup destination (set BACKUP_DIR to this container path)

目标
/app/backups
默认值
/mnt/user/makerworks/storage/backups
价值
/mnt/user/makerworks/storage/backups
Bulk Import FolderPathrw

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.

目标
/app/imports
默认值
/mnt/user/makerworks/imports
价值
/mnt/user/makerworks/imports
DATABASE_URLVariable

Postgres connection string (must be reachable from the container)

默认值
postgresql://postgres:postgres@postgres:5432/makerworks?schema=public
价值
postgresql://postgres:postgres@postgres:5432/makerworks?schema=public
REDIS_URLVariable

Redis connection string used for BullMQ processing queues

默认值
redis://makerworks-redis:6379
价值
redis://makerworks-redis:6379
BASE_URLVariable

Public URL users access (used for redirects/cookies)

默认值
https://makerworks.example.com
价值
https://makerworks.example.com
JWT_SECRETVariable

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

ADMIN_EMAILVariable

Email for the bootstrap administrator account

默认值
admin@example.com
价值
admin@example.com
ADMIN_PASSWORDVariable

Password for the bootstrap administrator (rotated on change)

ADMIN_NAMEVariable

Display name for the bootstrap administrator account

默认值
Admin
价值
Admin
STORAGE_DIRVariable

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

默认值
/app/storage
价值
/app/storage
DIRECT_UPLOAD_URLVariable

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

BULK_UPLOAD_DIRVariable

Default in-container folder scanned by the bulk upload importer

默认值
/app/imports
价值
/app/imports
BULK_UPLOAD_BASE_URLVariable

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

默认值
http://127.0.0.1:3000
价值
http://127.0.0.1:3000
S3_BUCKETVariable

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

S3_REGIONVariable

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

S3_ACCESS_KEY_IDVariable

Access key for the configured S3-compatible storage

S3_SECRET_ACCESS_KEYVariable

Secret key for the configured S3-compatible storage

COOKIE_SECUREVariable

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

默认值
true
价值
true
SKIP_DOCKERVariable

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

默认值
1
价值
1
BACKUP_DIRVariable

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

默认值
/app/backups
价值
/app/backups
PG_DUMP_BINVariable

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

默认值
/usr/bin/pg_dump
价值
/usr/bin/pg_dump
PSQL_BINVariable

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

默认值
/usr/bin/psql
价值
/usr/bin/psql
BACKUP_DOCKER_SERVICEVariable

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

默认值
db
价值
db
BACKUP_SCHEDULE_ENABLEDVariable

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

默认值
1
价值
1
BACKUP_SCHEDULE_TIME_UTCVariable

Daily backup time in UTC (HH:mm)

默认值
03:00
价值
03:00
BACKUP_RUN_ON_STARTVariable

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

默认值
0
价值
0
BACKUP_PRUNE_ON_BACKUPVariable

Prune old backups immediately after each successful backup

默认值
1
价值
1
BACKUP_RETENTION_DAYSVariable

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

默认值
14
价值
14
BACKUP_RETENTION_MAX_COUNTVariable

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

默认值
30
价值
30
PROCESSING_QUEUE_ATTEMPTSVariable

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

默认值
5
价值
5
PROCESSING_QUEUE_BACKOFF_MSVariable

Exponential backoff delay (ms) between queue retries

默认值
5000
价值
5000
START_PROCESSING_WORKERVariable

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

默认值
1
价值
1
IMAGE_WORKER_CONCURRENCYVariable

Concurrency for image processing inside this container

默认值
2
价值
2
PREVIEW_WORKER_CONCURRENCYVariable

Concurrency for preview processing inside this container

默认值
1
价值
1
PRINTER_PROFILEVariable

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

默认值
BAMBU_X1C
价值
BAMBU_X1C
PRINTER_ELECTRIC_RATE_PER_KWHVariable

Electricity rate (per kWh) used for energy estimates

默认值
0.14
价值
0.14
PLA_PRICE_PER_KG_USDVariable

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

默认值
25.00
价值
25.00
PETG_PRICE_PER_KG_USDVariable

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

默认值
28.00
价值
28.00
NEXT_PUBLIC_PLA_PRICE_PER_KGVariable

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

默认值
25.00
价值
25.00
NEXT_PUBLIC_PETG_PRICE_PER_KGVariable

Expose PETG per-kg cost to the client

默认值
28.00
价值
28.00
COLOR_SURCHARGE_RATEVariable

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

默认值
0.05
价值
0.05
NEXT_PUBLIC_COLOR_SURCHARGE_RATEVariable

Expose the color surcharge rate to the client UI

默认值
0.05
价值
0.05
NEXT_PUBLIC_MAX_CART_COLORSVariable

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

默认值
4
价值
4
CURRENCYVariable

Back-end currency (USD or CAD)

默认值
USD
价值
USD
NEXT_PUBLIC_CURRENCYVariable

Client-facing currency label (must match CURRENCY)

默认值
USD
价值
USD
PLA_PRICE_PER_KG_CADVariable

Optional CAD override for PLA per-kg cost

PETG_PRICE_PER_KG_CADVariable

Optional CAD override for PETG per-kg cost

ENERGY_CAD_PER_HOURVariable

Optional CAD override for energy rate per hour

MINIMUM_PRICE_CADVariable

Optional CAD minimum price override

EXTRA_HOURLY_AFTER_FIRST_USDVariable

Extra hourly surcharge after first hour (USD context)

EXTRA_HOURLY_AFTER_FIRST_CADVariable

Extra hourly surcharge after first hour (CAD context)

STRIPE_SECRET_KEYVariable

Stripe secret key (starts with sk_live_ or sk_test_)

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEYVariable

Stripe publishable key used by the in-app checkout UI

STRIPE_WEBHOOK_SECRETVariable

Stripe webhook signing secret for /api/stripe/webhook

STRIPE_SHIPPING_RATE_IDVariable

Stripe shipping rate ID required when shipped checkout is enabled

STRIPE_INVOICE_DAYS_UNTIL_DUEVariable

Days until due for Stripe invoices sent from invoice checkout

默认值
14
价值
14
STRIPE_TAX_ENABLEDVariable

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

默认值
0
价值
0
PRINTLAB_BASE_URLVariable

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

默认值
http://PrintLab:8080
价值
http://PrintLab:8080
PRINTLAB_AUTH_HEADERVariable

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

PRINTLAB_SESSION_COOKIEVariable

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

PRINTLAB_API_KEYVariable

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

PRINTLAB_API_KEY_HEADERVariable

Header name used with PRINTLAB_API_KEY

默认值
X-API-Key
价值
X-API-Key
MAKERWORKS_INBOUND_SECRETVariable

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

PRINTLAB_WEBHOOK_SECRETVariable

Shared secret expected on PrintLab callbacks into MakerWorks

STOCKWORKS_BASE_URLVariable

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

默认值
http://StockWorks:8000
价值
http://StockWorks:8000
STOCKWORKS_ADMIN_USERNAMEVariable

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

STOCKWORKS_ADMIN_PASSWORDVariable

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

STOCKWORKS_USERNAMEVariable

Optional StockWorks username fallback

STOCKWORKS_PASSWORDVariable

Optional StockWorks password fallback

STOCKWORKS_COLOR_OVERRIDESVariable

Optional JSON color override map for StockWorks filament availability

HOLIDAY_THEMEVariable

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

NEXT_PUBLIC_CONTACT_EMAILVariable

Contact email shown on the site

默认值
info@makerworks.app
价值
info@makerworks.app
NEXT_PUBLIC_BRAND_NAMEVariable

Display name shown across the storefront and emails

默认值
MakerWorks
价值
MakerWorks
NEXT_PUBLIC_BRAND_VERSIONVariable

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

默认值
v2
价值
v2
NEXT_PUBLIC_BRAND_LAB_NAMEVariable

Label used for the pickup location in checkout copy

默认值
MakerWorks lab
价值
MakerWorks lab
NEXT_PUBLIC_BRAND_HANDLEVariable

Default handle placeholder for social profile fields

默认值
@makerworks
价值
@makerworks
SMTP_HOSTVariable

SMTP host for verification emails

SMTP_PORTVariable

SMTP port

SMTP_USERVariable

SMTP username

SMTP_PASSWORDVariable

SMTP password

SMTP_SECUREVariable

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

RECEIPT_FROM_EMAILVariable

From address for verification/receipt emails

默认值
MakerWorks Receipts <receipts@makerworks.app>
价值
MakerWorks Receipts <receipts@makerworks.app>
RECEIPT_REPLY_TO_EMAILVariable

Reply-to address for outgoing emails

默认值
MakerWorks <info@makerworks.app>
价值
MakerWorks <info@makerworks.app>
DISCORD_BOT_TOKENVariable

Optional bot token used for Discord announcements

DISCORD_CHANNEL_IDVariable

Discord channel ID used for announcements

DISCORD_ADMIN_BOT_TOKENVariable

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

DISCORD_ADMIN_CHANNEL_IDVariable

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

详细信息

存储库
ghcr.io/schartrand77/mkw2:latest
最后更新2026-06-01
初见2025-12-19

在Unraid 上运行 MakerWorks-v2 。

MakerWorks-v2 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。