entrytwo

docs / invoices / getting-started / installation.md

Installation

Selbst gehostetes Invoices (Kontakte + KI-Rechnungen). Nicht entrytwo-Buchhaltung.

Repo: github.com/felixkrusch/invoices

Ops-Details im App-Repo: docs/PRODUCTION.md, docs/VPS-Auth-Install.md.

Betrieb: Die meisten Produktions-Setups nutzen einen VPS mit Docker und HTTPS. Du kannst genauso lokal installieren und produktiv nutzen (z. B. auf dem Mac): dieselbe volle App, wie klassische Buchhaltungssoftware ohne Cloud. Läuft auf deinem VPS oder lokal.

Lass die KI die Installation machen

Kein Terminal-Mensch? Du kannst Invoices trotzdem installieren. Gib einem KI-Coding-Agenten diese Seite (und das Repo) und bitte ihn, die Installation für dich zu erledigen — z. B. Claude Code, OpenClaw, Hermes, Cursor oder ein vergleichbares Tool, das Befehle auf deinem Rechner oder VPS ausführen kann. Sag ihm dein Ziel (lokal Mac vs. VPS + Domain), schick Fehlermeldungen zurück, wenn etwas scheitert, und teile Secrets (Passwörter, API-Keys) nicht in Chats, denen du nicht vertraust. Die Schritte unten bleiben die Quelle der Wahrheit; der Agent führt dich nur durch. Kanonische Agent-Dateien: llms.txt und invoices SKILL.md.

Schnellstart (Docker)

git clone https://github.com/felixkrusch/invoices.git
cd invoices
cp .env.example .env
# LICENSE_VERIFY_URL=https://entrytwo.com/api/license/verify
# Port 3000 belegt (z. B. entrytwo): APP_PORT=3001
docker compose up -d --build

Site öffnen → ersten ADMIN anlegen → Firma → Steuersätze → Kontakt → Rechnung.

GET /api/health → ready: true. 30-Tage-Test ohne Key. Menschen kaufen unter Kaufen; Agenten zahlen nicht. Danach POST /api/license/activate mit einem invoices-et1.-Key.

Handler-Modus (ein Compose pro Mandant)

Nicht mandantenfähig. Pro Firma: eigener COMPOSE_PROJECT_NAME, eigener APP_PORT, eigene Secrets, eigene .invbackup-Dateien. Nicht mit entrytwo-.etbackup mischen.

Produktion

Secrets, echtes SMTP/OAuth, AUTH_URL, DNS vor HTTPS, Worker für E-Mail, danach Invoices-Lizenz aktivieren.

Volles Ledger? entrytwo Installation.