🌐 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

Release (neues Image bauen + pushen)

./release.sh v1.2.3

Optional direkt .env auf das neue Tag setzen und deployen:

./release.sh v1.2.3 --set-env --deploy

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

PDF_TO_ICS_IMAGE=git.file-archive.de/webfarben/pdf_to_ics:v1.2.2

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 release.sh README.md WEB_README.md

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

1.7 KiB Raw Blame History