Files
pdf_to_ics/WEB_README.md

1.5 KiB

🌐 Web-Version (Docker-only)

Diese Anwendung wird ausschließlich als Container betrieben.

Voraussetzungen

  • Docker + Docker Compose
  • Optional externes Netzwerk proxy (wenn Reverse Proxy genutzt wird)

Erststart

cp .env.example .env
./deploy.sh

Update

./update.sh

Für ein neues Release den Tag in .env erhöhen, z. B.:

PDF_TO_ICS_IMAGE=ghcr.io/webfarben/pdf_to_ics:v1.1.0

Danach ./update.sh ausführen.

Hinweis: deploy.sh und update.sh versuchen zuerst einen Registry-Pull. Wenn der Pull fehlschlägt, wird automatisch mit einem bereits lokal vorhandenen Image gleichen Tags weitergemacht.

Manuelle Kommandos (optional)

Starten:

docker compose -f docker-compose.deploy.yml up -d

Status/Logs:

docker compose -f docker-compose.deploy.yml ps
docker compose -f docker-compose.deploy.yml logs -f pdf-to-ics-web

Stoppen:

docker compose -f docker-compose.deploy.yml down

Sicherheit

Optional App-Basic-Auth in .env setzen:

WEB_AUTH_USER=kalender
WEB_AUTH_PASSWORD=BitteSicheresPasswortSetzen

Für öffentliches Deployment zusätzlich Reverse Proxy + HTTPS verwenden.

Schlanker Server-Checkout (Sparse)

git clone --filter=blob:none --sparse <REPO_URL> pdf_to_ics
cd pdf_to_ics
git sparse-checkout set docker-compose.deploy.yml .env.example deploy.sh update.sh README.md WEB_README.md

Hinweis: Ein bestehender Voll-Clone wird dadurch nicht automatisch kleiner.