Deployment
Run Daedalus as a native desktop app or a Docker container on your own server. Your data, your infrastructure.
Overview
Daedalus is designed to run wherever works best for your setup. The desktop app is ideal for a single workstation, and Docker works great for a home server or NAS.
Desktop App (Wails)
The desktop app runs as a native application on macOS and Windows, powered by the Wails framework.
Building from Source
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Clone the repository
git clone https://github.com/philjestin/Daedalus.git
cd daedalus
# Run in development mode
wails dev
# Build for production
wails buildDesktop Features
- Full filesystem access for 3MF file parsing
- System tray icon with quick status
- Native window management and menus
- Automatic updates (when enabled)
Docker
Run Daedalus as a containerized web application with Docker:
Docker Compose
version: "3.8"
services:
daedalus:
image: daedalus:latest
build: .
ports:
- "8080:8080"
volumes:
- daedalus-data:/app/data
environment:
- DAEDALUS_PORT=8080
- DAEDALUS_DATA_DIR=/app/data
volumes:
daedalus-data:Running with Docker
# Build the image
docker build -t daedalus .
# Run with a named volume for data persistence
docker run -d \
--name daedalus \
-p 8080:8080 \
-v daedalus-data:/app/data \
daedalus
# Or use Docker Compose
docker compose up -dDocker Features
- Multi-stage build for minimal image size
- Embedded SQLite database (no external DB required)
- Volume mount for persistent data
- Health check endpoint at
/health
Environment Variables
| Variable | Default | Description |
|---|---|---|
DAEDALUS_PORT | 8080 | HTTP server port |
DAEDALUS_DATA_DIR | ./data | Directory for database and uploads |
DAEDALUS_BACKUP_DIR | ./backups | Directory for automatic backups |
DAEDALUS_LOG_LEVEL | info | Logging level (debug, info, warn, error) |
DAEDALUS_CORS_ORIGINS | * | Allowed CORS origins (comma-separated) |
ETSY_API_KEY | — | Etsy OAuth application key |
SHOPIFY_API_KEY | — | Shopify OAuth application key |
SHOPIFY_API_SECRET | — | Shopify OAuth secret |
SQUARESPACE_API_KEY | — | Squarespace API key |
OCR_API_KEY | — | OCR service API key for receipt parsing |
Tip: For local development with LAN-connected printers, the desktop app or Docker on the same network gives the best experience.