Erste Schritte
Erster Start
Der Setup-Assistent legt Administrator, Firmendaten und die erste Rechnungsvorlage an.
Beim ersten Start einer Einzelinstanz ist die Datenbank leer und jede Seite leitet auf /setup weiter. Der Assistent ist durch das Setup-Token aus dem Log geschützt (oder den Wert von SETUP_TOKEN):
docker compose logs annuva | grep -A1 "Setup required"Die Schritte
- Setup-Token – beweist, dass dir der Server gehört.
- Datenbank – prüft die in der Umgebung konfigurierte Verbindung und spielt die Migrationen ein.
- Administrator – der erste Benutzer. Passwörter brauchen mindestens 9 Zeichen mit Groß- und Kleinbuchstaben und einer Ziffer.
- Firma – Name, Anschrift, Kontakt, Besteuerung (Kleinunternehmer oder Regelbesteuerung), Bankverbindung und das Muster der Rechnungsnummer, z. B.
RE-{YYYY}-{NNN}. - Rechnungsvorlage – Briefkopf, Fußzeile, Zahlungsbedingungen und Texte. Die Vorschau zeigt eine Beispielrechnung.
- Kunden – optional gleich die ersten Kunden anlegen, mit wiederkehrenden Leistungen, Ressourcen und Fixkosten.
Nach dem Setup ist der Assistent gesperrt; das Token wird nicht mehr angenommen.
Nach dem Setup
- Weitere Benutzer unter Benutzer anlegen (Rollen Admin und Benutzer).
- Unter Profil → API-Tokens ein API-Token erstellen, wenn du die REST-API oder einen KI-Assistenten nutzen willst.
- Deine Steuerjahre mit dem Grenzsteuersatz eintragen, damit das Dashboard die Steuer schätzen kann.
- SMTP einrichten (siehe Konfiguration), um Rechnungen und Mahnungen direkt aus Annuva zu verschicken.