Einrichtung
Installationsleitfaden
Den passenden Bereitstellungsweg für QuoteNode wählen und verstehen, was in jeder Topologie funktioniert.
Installation
QuoteNode läuft als Docker-Container. Für normale Bereitstellungen müssen Sie weder Java, Node.js, PostgreSQL noch Gotenberg auf dem Host installieren. Die wichtigste Entscheidung ist, von wo die Anwendung erreichbar sein soll: nur von Ihrem Laptop, aus dem Büronetz (LAN) oder aus dem öffentlichen Internet.
Jede Anleitung installiert ein Release-Paket: eine Compose-Datei, die die getesteten Release-Images per Digest festgelegt startet. Auf Ihrem Rechner wird nichts kompiliert, und jede Installation eines Release nutzt dieselben Images. Release-Images werden für 64-Bit-x86-Hosts (linux/amd64) gebaut.
Bereitstellungsweg wählen
| Topologie | Adresse | Öffentliche Angebotslinks | Links in E-Mails | HTTPS | Zweck |
|---|---|---|---|---|---|
| Laptop/lokal | http://localhost |
nur auf demselben Rechner | für externe Kunden nutzlos | nein | Test/Demo |
| Windows im LAN | http://<PC-IP> oder lokales DNS |
nur Clients im LAN | nur interne Empfänger | optional/intern | Test im Büro |
| Linux-Server im LAN | http://<Server-IP> oder lokales DNS |
nur Clients im LAN/VPN | intern, sofern nicht erreichbar | optional/intern | internes Vertriebsteam |
| Öffentlicher Ubuntu-Server (VPS) | öffentliche Domain + HTTPS | funktionieren für Kunden | funktionieren mit SMTP und Domain | erforderlich | Beta-Produktion |
| Portainer/QNAP/NAS | hostspezifische Docker-Oberfläche | abhängig von Routing/NAT/Domain | abhängig von Routing/SMTP | für Kundenlinks erforderlich | fortgeschrittener Heim-/KMU-Betrieb |
| Coolify | öffentliche Domain + verwalteter Proxy | funktionieren für Kunden | funktionieren mit SMTP und Domain | von Coolify verwaltet | einfachste öffentliche Bereitstellung |
Installationsanleitungen
- Lokaler Laptop — schnelle Evaluierung auf einem Rechner.
- Windows-LAN-Server — Docker Desktop auf einem PC im Büronetz.
- Linux-LAN-Server — Docker Engine auf einem internen Server oder einer VM.
- Öffentlicher Ubuntu-Server — öffentliche Domain, HTTPS, SMTP, Sicherungen und Firewall-Grundlagen.
- Coolify — Release-Paket in einer Coolify-Docker-Compose-Ressource hinter dem Coolify-Proxy.
- Portainer, QNAP oder NAS — fortgeschrittene Hinweise für Plattformen mit Docker-Oberfläche.
- QuoteNode aktualisieren — Wechsel auf das nächste Release-Paket und sicheres Zurückrollen.
Gemeinsame Referenzen
- Bereitstellungs-Umgebungsvariablen — minimale Variablen für die Installationsanleitungen.
- Fehlerbehebung bei der Installation — typische Probleme mit Links, CORS, SMTP, DNS und verlorenen Secrets.
- Umgebungsvariablen-Referenz — vollständiger Variablenkatalog.
- Sicherung und Wiederherstellung — Sicherungsstrategie und Wiederherstellung.
- Bereitstellungsoptionen — Überblick auf Architekturebene.
Bevor Sie Links veröffentlichen
QuoteNode erzeugt öffentliche Angebotslinks, Links zu Benachrichtigungseinstellungen und E-Mails. Diese Links funktionieren nur für Empfänger, die dieselbe Adresse erreichen, die der Browser verwendet.
- Ein unter
http://localhosterzeugter Link funktioniert nur auf demselben Rechner. - Ein unter
http://192.168.x.xerzeugter Link funktioniert nur für Personen in diesem LAN oder VPN. - Ein unter
https://crm.example.comerzeugter Link funktioniert öffentlich nur mit korrekt eingerichtetem DNS, HTTPS, Proxy-Routing und Firewall. - E-Mail-Versand erfordert SMTP. Manueller PDF-Download und manuelles Teilen öffentlicher Links nicht.
Mindestressourcen
| Bereitstellung | RAM | CPU | Festplatte |
|---|---|---|---|
| Evaluierung / Einzelnutzung | 2 GB | 1 Kern | 10 GB SSD |
| Kleines Team | 4 GB | 2 Kerne | 20 GB SSD |
| Größere Beta-Umgebung | 8 GB | 4 Kerne | 50 GB SSD |
Das sind vorsichtige Startwerte. Große Kataloge, häufige PDF-Erzeugung, viele Sicherungen und Produktbilder erhöhen den Speicher- und Plattenbedarf.
Container-Limits, RAM/CPU-Tuning und das Vermeiden von Speichermangel beschreibt Systemressourcen.