GuidoandClaude Opus 4.8
a998f70241
Ein eigener Dienst-Benutzer kommt nicht an Code/venv unter /root (Modus 700). install.sh setzt User/Group der Unit jetzt auf den Eigentümer des Repos – bei Klon als root nach /root also root. Kein useradd mehr. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Deployment (Proxmox-LXC + Nginx Proxy Manager)
Voraussetzung: Python 3.11+ – also ein Debian-12- oder Ubuntu-24.04-LXC (Debian 11 hat nur Python 3.9 und wird nicht unterstützt).
install.shprüft das und bricht mit einer klaren Meldung ab, falls die Version zu alt ist.
Installation
Im LXC (Debian 12 / Ubuntu 24.04) das Repo klonen und als root installieren:
git clone <repo-url> /opt/certain-finance
cd /opt/certain-finance
sudo ./deploy/install.sh
Das Skript installiert Python/Node, richtet eine venv ein, baut das Frontend,
erzeugt /etc/certain-finance/env (mit Zufallsgeheimnissen), legt den systemd-
Dienst certain-finance an und startet ihn. Node wird nur zum Bauen gebraucht;
der laufende Dienst ist reines Python.
Direktzugriff (http://IP:Port)
Standardmäßig lauscht der Dienst auf 0.0.0.0:<APP_PORT> (Standard-Port 8071) und
ist damit direkt im LAN erreichbar: http://<LXC-IP>:8071. Dafür ist
APP_COOKIE_SECURE=false gesetzt (sonst speichert der Browser die Sitzung über
reines HTTP nicht). Möchtest du den Zugriff auf einen Reverse-Proxy auf demselben
Host beschränken, setze APP_BIND_HOST=127.0.0.1 in /etc/certain-finance/env.
Optional: HTTPS über Nginx Proxy Manager
Wenn du von außen per HTTPS zugreifen willst, einen Proxy Host anlegen:
- Domain Names: deine (Sub-)Domain
- Scheme:
http - Forward Hostname / IP: IP dieses LXC
- Forward Port: Wert von
APP_PORT(Standard8071) - Block Common Exploits: an
- Websockets Support: nicht nötig
- SSL: Let's Encrypt-Zertifikat anfordern, „Force SSL" an
Für spätere CSV-/PDF-Uploads in den Advanced-Einstellungen des Hosts
client_max_body_size 20m; setzen.
Bei ausschließlichem HTTPS-Zugriff kannst du APP_COOKIE_SECURE=true in
/etc/certain-finance/env setzen (danach systemctl restart certain-finance) –
dann werden die Sitzungs-Cookies nur über HTTPS gesendet. Für gemischten Zugriff
(HTTP im LAN und HTTPS von außen) belasse es bei false.
Betrieb
systemctl status certain-finance # Status
journalctl -u certain-finance -f # Logs
systemctl restart certain-finance # Neustart
sudo ./deploy/update.sh # Update (git pull + build + Migration + Neustart)
Backup
Die Datenbank liegt unter /var/lib/certain-finance/app.db. update.sh legt vor
jeder Migration automatisch eine Kopie unter /var/lib/certain-finance/backups/
an. Zusätzlich empfiehlt sich ein Proxmox-vzdump-Snapshot des Containers.