Get started

Good to know: the web interface of Nodvard Deck and Nodvard Dock is German only for now. An English interface is planned. This website and the guides are in English.

1. Have Docker and Docker Compose ready. A Raspberry Pi needs a 64-bit system.
2. Get Deck and start it.
   In a terminal

   mkdir ~/nodvard-deck && cd ~/nodvard-deck
   curl -fsSL -o compose.yml https://raw.githubusercontent.com/nodvard/deck/main/deploy/compose.standalone.yml
   docker compose up -d

   What is in compose.yml?

   One container, one port, one volume for the data. No Docker socket, no special privileges. The complete file is on GitHub.

   name: nodvard-deck
   services:
     nodvard-deck:
       image: ghcr.io/nodvard/deck:latest
       restart: unless-stopped
       ports:
         - "${NODVARD_DECK_PORT:-8080}:8080"
       volumes:
         - nodvard_deck_data:/app/data
         # Optional: a folder for backups, for example on a NAS
         # - ./sicherungen:/backups
       healthcheck: …
   volumes:
     nodvard_deck_data:
       name: nodvard-deck-data

   On Windows, these commands are for WSL or Git Bash. In PowerShell, write curl.exe instead of curl and run the commands one by one.

3. Open it in your browser: http://<your-server>:8080. Deck asks for a setup code. docker compose logs nodvard-deck in the same folder shows it, the line starts with “Einrichtungscode”.
4. Follow the assistant. It guides you through your account and the first server. If you only want to have a look, take the sample data and throw it out later.