Deployment on PrintMaster Docs

Docker Deployment

Mon, 01 Jan 0001 00:00:00 +0000

Deploy PrintMaster Server using Docker containers with multi-architecture support.

Quick Start

docker run -d \
 --name printmaster-server \
 -p 9443:9443 \
 -v printmaster-data:/var/lib/printmaster/server \
 -e ADMIN_PASSWORD=your-secure-password \
 ghcr.io/printmaster-org/printmaster-server:latest

Access at https://localhost:9443 with username admin. Standalone mode is HTTPS-only with a self-signed certificate by default; HTTP 9090 is a reverse-proxy backend, not the default listener.

Set a strong bootstrap password before exposing the server. At every startup, ADMIN_USER (default admin) is created only if that username is absent. ADMIN_PASSWORD does not reset an existing account’s password or role.

PostgreSQL and TimescaleDB Upgrades

Mon, 01 Jan 0001 00:00:00 +0000

PrintMaster’s Compose examples use timescale/timescaledb:latest-pg18 for new deployments. The server supports PostgreSQL 18 and TimescaleDB through the standard pgx driver and TimescaleDB APIs.

Important warning

Changing latest-pg15 to latest-pg18 while keeping the existing /var/lib/postgresql volume will not perform a PostgreSQL major upgrade. PostgreSQL 15 and 18 use incompatible data-directory formats. The container will normally refuse to start, and deleting the volume would destroy data.

For PG18, mount the volume at /var/lib/postgresql, not /var/lib/postgresql/data. The PG18 image manages its version-specific data directory below that root.

Unraid Deployment

Mon, 01 Jan 0001 00:00:00 +0000

Deploy PrintMaster Server on Unraid using the Docker container.

Installation Methods

Method 1: Community Applications (Recommended)

Install Community Applications plugin if not already installed
Search for “PrintMaster Server”
Click Install
Configure settings (see below)
Click Apply

Method 2: Manual Docker Setup

Go to Docker tab in Unraid
Click Add Container
Configure:

Setting	Value
Name	`PrintMaster-Server`
Repository	`ghcr.io/printmaster-org/printmaster-server:latest`
Network Type	`Bridge`
Port	`9090` → `9090` (TCP)
Volume	`/mnt/user/appdata/printmaster-server/data` → `/var/lib/printmaster/server`
Volume	`/mnt/user/appdata/printmaster-server/logs` → `/var/log/printmaster/server`

Configuration

Essential Settings

Setting	Value	Description
HTTP Port	`9090`	Web interface and API
Data Directory	`/mnt/user/appdata/printmaster-server/data`	Database storage
Logs Directory	`/mnt/user/appdata/printmaster-server/logs`	Application logs
Timezone	Your timezone (e.g., `America/New_York`)	For correct timestamps

Environment Variables

Variable	Value	Description
`BIND_ADDRESS`	`0.0.0.0`	Allow external access
`BEHIND_PROXY`	`true` or `false`	Behind Nginx Proxy Manager?
`LOG_LEVEL`	`info`	`debug`, `info`, `warn`, `error`
`TZ`	`America/New_York`	Your timezone
`PM_DISABLE_SELFUPDATE`	`true`	Recommended for Docker

Reverse Proxy Setup

With Nginx Proxy Manager

Set container variables: