Getting started

Run with Docker

From the repository root:

docker compose up --build

Configure environment variables in .env (Postgres, Redis, S3/MinIO, secrets).

Sign in

Open the React frontend (default dev port 5173 when running Vite locally, or your Docker/nginx URL in composed setups). Authenticate with your configured user account.

Explore the warehouse

1. Open Warehouse from the sidebar.
2. Browse components, locations, and categories.
3. Open a component detail page to edit parameters, documents, and stock.

Configure integrations

• KiCad — KiCad HTTP library
• MCP — MCP integration
• Service tokens — Service tokens for printers and devices
• Hardware — Hardware to connect barcode scanners and printers

Where to go next

• Product overview — the full list of areas and how they fit together
• Components, Categories, Locations — the core warehouse catalog
• Purchases, Inventory — day-to-day warehouse operations
• BOMs — production BOM workflows
• Print queues — printing labels for components, packets, and locations