Quickstart

From an empty directory to your first confirmed print. Measured: 7 min 21 s on a clean Windows machine.

Print Center after setup showing first label ready to print

What you see at the end: the Print Center with your first label selected and the live ZPL preview on the right.

Step 1

Download & verify

Get the release from GitHub and verify all checksums.

gh release download v0.1.0-beta.1 --repo Stevethebeef/openlabelengine
# verify: all 8 checksums must match
Step 2

Start the Center

Run the installer. It configures autostart and opens port 8090.

# Windows (amd64)
.\install.ps1 -Port 8090
# Linux (amd64/arm64)
chmod +x install.sh && ./install.sh --port 8090
Step 3

Create your admin account

Open the browser at localhost:8090. The first-run wizard creates your admin account. No default password exists.

Step 4

Connect a Runner (one line)

The Runner enrolls via CSR and appears in the Center immediately.

ole runner join --url https://your-center:8090 --group production
Step 5

Print your first label

In the Center: Design → choose a gallery template → fill variables → print. You will see confirmed ✓✓ when the printer acknowledges. That check mark means the printer confirmed, not just received.

Before you go live: Your backup target is simple — the data directory (contains all labels, flows, archive) plus any encryption keys. Without them, every credential reference becomes permanently unreadable. See Operate →
Honest note: "sent" (✓) means the job was handed to the printer queue. "confirmed" (✓✓) means the printer acknowledged printing. These are different states — we never merge them into one green lie.
Join the beta → Full install guide →
Setup wizard step 1: printer discovery with subnet scan and manual IP

First-time setup: printers are found via subnet scan, manual IP or OS printer list..

Setup wizard step 2: test print showing sent then confirmed status

Testdruck: Erst gesendet, dann bestätigt. The printer acknowledges — the checkmark carries the confirmation.