From ae61fbea7a07c07028662431a2e0079ca80ac53c Mon Sep 17 00:00:00 2001 From: Bobban Rydh Date: Thu, 22 Oct 2026 21:32:47 +0200 Subject: [PATCH] first commit --- .env.example | 25 +++++++++++++++---------- README.md | 2 +- docker-compose.dev.yml | 27 +++++++++++++++++---------- docker-compose.prod.yml | 12 +++++++----- 4 files changed, 40 insertions(+), 26 deletions(-) diff --git a/.env.example b/.env.example index c72f1f2..ea82f27 100644 --- a/.env.example +++ b/.env.example @@ -1,31 +1,36 @@ # Kopiera till .env och fyll i. .env ska aldrig checkas in. +# Samma fil läses av båda compose-filerna, och allt i den skickas vidare in i appen. +# Använd en .env per miljö (utveckling eller produktion), de har olika AUTH_URL och hemligheter. -# ---------- Produktion (docker-compose.prod.yml) ---------- +# ---------- Produktion (docker-compose.prod.yml): obligatoriskt ---------- # Använd bara bokstäver och siffror i lösenordet, det ingår i en URL. POSTGRES_PASSWORD= -POSTGRES_USER=bookmanager -POSTGRES_DB=bookmanager - # Slumpmässig hemlighet för sessioner: openssl rand -base64 32 AUTH_SECRET= # Adressen som användarna öppnar, utan avslutande snedstreck AUTH_URL=https://bocker.example.com -# Port på värddatorn som appen publiceras på -APP_PORT=3000 -# ---------- Authentik ---------- +# ---------- Authentik (obligatoriskt i produktion, valfritt i utveckling) ---------- # Issuer-URL från din OAuth2/OpenID-provider i Authentik, med avslutande snedstreck: # https://authentik.example.com/application/o/bokplanerare/ AUTHENTIK_ISSUER= AUTHENTIK_CLIENT_ID= AUTHENTIK_CLIENT_SECRET= -# ---------- Kartor (valfritt) ---------- -# Standard är OpenStreetMaps publika servrar, som är tänkta för lätt användning. +# ---------- Valfritt ---------- +# POSTGRES_USER=bookmanager +# POSTGRES_DB=bookmanager +# Port på värddatorn som appen publiceras på (standard 3000) +# APP_PORT=3000 + +# Kartor: standard är OpenStreetMaps publika servrar, som är tänkta för lätt användning. # MAP_TILE_URL=https://tile.openstreetmap.org/{z}/{x}/{y}.png # MAP_TILE_ATTRIBUTION=© OpenStreetMap-bidragsgivare # MAP_GEOCODER_URL=https://nominatim.openstreetmap.org/search -# ---------- Utveckling (docker-compose.dev.yml) ---------- +# ---------- Bara utveckling (docker-compose.dev.yml) ---------- +# Saknas AUTH_SECRET och AUTH_URL används utvecklingsvärden (http://localhost:3000). +# Testar du mot din riktiga Authentik: sätt AUTH_URL till http://localhost:3000, fyll i AUTHENTIK_* +# och lägg till http://localhost:3000/api/auth/callback/authentik som Redirect URI i Authentik. # Inloggning utan Authentik, bara i utvecklingsläge. Sätt false för att testa mot Authentik. # AUTH_DEV_LOGIN=true diff --git a/README.md b/README.md index ebc9b39..cc9cb80 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ docker compose -f docker-compose.dev.yml up --build Öppna http://localhost:3000. Utan Authentik-inställningar visas en **utvecklarinloggning** (bara i utvecklingsläge, finns aldrig i produktionsbygget). Källkoden monteras in så ändringar slår igenom direkt. -Vill du testa mot din riktiga Authentik: kopiera `.env.example` till `.env`, fyll i `AUTHENTIK_*` och sätt `AUTH_DEV_LOGIN=false`. +Vill du testa mot din riktiga Authentik: kopiera `.env.example` till `.env`, fyll i `AUTHENTIK_*` och sätt `AUTH_DEV_LOGIN=false`. Allt i `.env` skickas in i appen; saknas `AUTH_SECRET` och `AUTH_URL` används utvecklingsvärden (`http://localhost:3000`). Ändrar du `.env` räcker det att köra `up` igen, ingen ombyggnad behövs. Ändrar du `prisma/schema.prisma`: diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index 0f1f652..8baf61d 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -1,20 +1,23 @@ # Utvecklingsmiljö: docker compose -f docker-compose.dev.yml up --build -# Appen körs med hot reload på http://localhost:3000 och källkoden monteras in från mappen. +# Appen körs med hot reload på http://localhost:${APP_PORT:-3000} och källkoden monteras in från mappen. +# +# Inställningar läses från .env (valfri, se .env.example). Allt som står i .env skickas vidare +# till appen, och saknas något används utvecklingsvärdena nedan. name: bookmanager-dev services: db: image: postgres:16-alpine environment: - POSTGRES_USER: bookmanager - POSTGRES_PASSWORD: bookmanager - POSTGRES_DB: bookmanager + POSTGRES_USER: ${POSTGRES_USER:-bookmanager} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-bookmanager} + POSTGRES_DB: ${POSTGRES_DB:-bookmanager} ports: - "5432:5432" # för t.ex. DBeaver eller psql från värddatorn volumes: - dev-db:/var/lib/postgresql/data healthcheck: - test: ["CMD-SHELL", "pg_isready -U bookmanager -d bookmanager"] + test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"] interval: 5s timeout: 5s retries: 10 @@ -26,14 +29,18 @@ services: depends_on: db: condition: service_healthy + # Hela .env följer med in i containern (AUTH_*, AUTHENTIK_*, MAP_* ...). Filen får saknas. + env_file: + - path: .env + required: false + # Poster här går före .env. De med :-värde läser .env och faller tillbaka på utvecklingsvärdet. environment: - DATABASE_URL: postgresql://bookmanager:bookmanager@db:5432/bookmanager - AUTH_SECRET: dev-only-secret-change-me - AUTH_URL: http://localhost:3000 + DATABASE_URL: postgresql://${POSTGRES_USER:-bookmanager}:${POSTGRES_PASSWORD:-bookmanager}@db:5432/${POSTGRES_DB:-bookmanager} + AUTH_SECRET: ${AUTH_SECRET:-dev-only-secret-change-me} + AUTH_URL: ${AUTH_URL:-http://localhost:3000} AUTH_TRUST_HOST: "true" # Lokal inloggning utan Authentik. Fungerar aldrig i produktionsbygget. AUTH_DEV_LOGIN: ${AUTH_DEV_LOGIN:-true} - # Fyll i .env för att testa mot din riktiga Authentik AUTHENTIK_ISSUER: ${AUTHENTIK_ISSUER:-} AUTHENTIK_CLIENT_ID: ${AUTHENTIK_CLIENT_ID:-} AUTHENTIK_CLIENT_SECRET: ${AUTHENTIK_CLIENT_SECRET:-} @@ -41,7 +48,7 @@ services: WATCHPACK_POLLING: "true" # filändringar upptäcks även via Windows/Mac-volymer NEXT_TELEMETRY_DISABLED: "1" ports: - - "3000:3000" + - "${APP_PORT:-3000}:3000" volumes: - .:/app - node-modules:/app/node_modules # beroenden från bilden, inte från värddatorn diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml index 9ee6bd0..2ea1cb7 100644 --- a/docker-compose.prod.yml +++ b/docker-compose.prod.yml @@ -1,5 +1,5 @@ # Produktion: docker compose -f docker-compose.prod.yml --env-file .env up -d --build -# Alla hemligheter läses från .env (se .env.example). +# Inställningar läses från .env (se .env.example). Obligatoriska värden som saknas stoppar start med ett tydligt fel. name: bookmanager services: @@ -29,8 +29,13 @@ services: depends_on: db: condition: service_healthy + # Hela .env följer med in i appen (AUTH_*, AUTHENTIK_*, MAP_* ...), även sådant som läggs till senare. + # Det gör att den fungerar även när --env-file inte används, t.ex. vid driftsättning från Portainer. + env_file: + - .env + # Poster här går före .env: sammansatta värden och obligatoriska kontroller. environment: - DATABASE_URL: postgresql://${POSTGRES_USER:-bookmanager}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB:-bookmanager} + DATABASE_URL: postgresql://${POSTGRES_USER:-bookmanager}:${POSTGRES_PASSWORD:?Sätt POSTGRES_PASSWORD i .env}@db:5432/${POSTGRES_DB:-bookmanager} AUTH_SECRET: ${AUTH_SECRET:?Sätt AUTH_SECRET i .env} AUTH_URL: ${AUTH_URL:?Sätt AUTH_URL i .env, t.ex. https://bocker.example.com} AUTH_TRUST_HOST: "true" # appen körs bakom en omvänd proxy @@ -38,9 +43,6 @@ services: AUTHENTIK_CLIENT_ID: ${AUTHENTIK_CLIENT_ID:?Sätt AUTHENTIK_CLIENT_ID i .env} AUTHENTIK_CLIENT_SECRET: ${AUTHENTIK_CLIENT_SECRET:?Sätt AUTHENTIK_CLIENT_SECRET i .env} UPLOAD_DIR: /data/uploads - MAP_TILE_URL: ${MAP_TILE_URL:-https://tile.openstreetmap.org/{z}/{x}/{y}.png} - MAP_TILE_ATTRIBUTION: ${MAP_TILE_ATTRIBUTION:-© OpenStreetMap-bidragsgivare} - MAP_GEOCODER_URL: ${MAP_GEOCODER_URL:-https://nominatim.openstreetmap.org/search} volumes: - uploads:/data/uploads ports: