Back to Home
Daedalus Docs

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 build

Desktop 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 -d

Docker 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

VariableDefaultDescription
DAEDALUS_PORT8080HTTP server port
DAEDALUS_DATA_DIR./dataDirectory for database and uploads
DAEDALUS_BACKUP_DIR./backupsDirectory for automatic backups
DAEDALUS_LOG_LEVELinfoLogging level (debug, info, warn, error)
DAEDALUS_CORS_ORIGINS*Allowed CORS origins (comma-separated)
ETSY_API_KEYEtsy OAuth application key
SHOPIFY_API_KEYShopify OAuth application key
SHOPIFY_API_SECRETShopify OAuth secret
SQUARESPACE_API_KEYSquarespace API key
OCR_API_KEYOCR 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.