certain/deploy

Deployment (Proxmox-LXC + Nginx Proxy Manager)

Installation

Im LXC (Debian/Ubuntu) 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 (Standard 8071)
• 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.