Zum Hauptinhalt springen

Installation

StoreStash läuft in Docker — eine einzige Voraussetzung, ein Befehl zum Starten.

Voraussetzungen​

  • Docker Engine 24+ (rootless mode wird unterstützt ✅)
  • Docker Compose v2
  • Ca. 500 MB Speicher für die Container
Rootless Docker

StoreStash ist vollständig kompatibel mit rootless Docker. Alle Container laufen als non-root User.

Installation​

1. Repository klonen​

git clone https://github.com/Thoomaastb/StoreStash.git
cd StoreStash

2. Konfiguration erstellen​

cp .env.example .env

Öffne die .env Datei und setze mindestens:

SECRET_KEY=dein-zufaelliger-geheimer-schluessel
DEBUG=true
SECRET_KEY generieren

Verwende einen zufälligen String. Generiere ihn mit:

python -c "import secrets; print(secrets.token_urlsafe(32))"

Niemals den Default-Wert in Produktion verwenden!

3. Starten​

docker compose up -d

StoreStash ist jetzt erreichbar unter http://localhost:3000 🎉

4. Überprüfen​

docker compose ps          # Alle 4 Services sollten "running" sein
docker compose logs -f     # Logs verfolgen

Erster Start​

Beim ersten Start passiert automatisch:

  • Datenbank-Tabellen werden erstellt
  • 6 Standard-Lagerorte werden angelegt (Kühlschrank, Gefrierschrank, Speisekammer, ...)
  • 10 Standard-Kategorien werden angelegt (Obst & Gemüse, Milchprodukte, ...)

Falls du ohne Standarddaten starten möchtest:

SEED_DEFAULT_DATA=false

Docker-Services​

ServiceBeschreibungInterner Port
nginxReverse Proxy, Security Headers, Rate-Limiting80 → extern 3000
frontendSvelteKit SSR3000
backendFastAPI REST API8000
dbPostgreSQL 165432 (nicht exponiert)

Nächste Schritte​