ivly

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Warum für IT-Freelancer?

ivly steht noch am Anfang, und ich habe es vor allem für meinen eigenen Bedarf als IT-Freelancer entwickelt. Grundsätzlich eignet es sich für alle Solo-Selbstständigen und Unternehmen, die in Deutschland Rechnungen schreiben. Derzeit ist es auf einen Benutzer und eine Firma ausgelegt.

Was ist GOBL?

GOBL (Go Business Language) ist ein offenes, JSON-basiertes Format für Geschäftsdokumente wie Rechnungen, Parteien und Produkte, entwickelt von Invopop unter der Apache-2.0-Lizenz. ivly speichert alle Geschäftsdaten als GOBL-Dokumente und erzeugt daraus XRechnung und ZUGFeRD. Die Daten liegen damit in einem offenen, dokumentierten Format und sind nicht an ivly gebunden.

Docker oder Podman?

Beides. Standardmäßig läuft der Stack mit podman compose. Für Docker bei jedem make-Aufruf CONTAINER=docker mitgeben, etwa CONTAINER=docker make up.

Gibt es ivly als SaaS?

Nein, und das ist derzeit auch nicht geplant. ivly läuft auf der eigenen Infrastruktur, die Rechnungen bleiben bei dir.

Läuft ivly auch auf einem Server?

Ja. Neben dem Notebook läuft ivly auf jedem Linux-Server mit Podman oder Docker, etwa einem Homeserver oder einem gemieteten VPS. Für die automatisierte Installation auf Servern gibt es eine Ansible-Rolle, die ivly als systemd-Dienst (Podman Quadlet) einrichtet. Sie wird noch stabiler und ist die Grundlage für eine private, von unterwegs erreichbare Self-hosted-Lösung.

ivly hat keinen eingebauten Login. Auf einem von außen erreichbaren Server den Zugriff am Reverse Proxy schützen, etwa per Basic Auth oder mTLS.

Sammelt oder übermittelt ivly Daten?

Nein. Kein Tracking, keine Telemetrie, kein Nach-Hause-Telefonieren. Zur Laufzeit sprechen die Komponenten nur innerhalb des Stacks miteinander. Der optionale KI-Assistent nutzt eine selbst betriebene Ollama-Instanz.

Läuft ivly offline oder air-gapped?

Nach der Installation braucht ivly keine Internetverbindung. Installation und Upgrades laden die Container-Images herunter, und automatisches HTTPS über Let’s Encrypt braucht Internetzugang. Ein vollständig air-gapped Betrieb mit von Hand übertragenen Images ist grundsätzlich möglich, aber nicht getestet.

Gibt es eine Online-Demo?

Noch nicht, eine Demo ist in Arbeit.

Bis dahin lässt sich schnell eine eigene aufsetzen: ivly-api bringt einen Seeder mit, der die Datenbank mit Demodaten füllt, also Firmendaten, Kunden, Produkte und Rechnungen samt Entwürfen. Im Devcontainer von ivly-api make seed ausführen, oder make seed CLEAR=1, um die Datenbank vorher zurückzusetzen.

Kommt eine Desktop-App?

Nein, das ist nicht geplant. ivly läuft im Browser, der Stack in Containern auf der eigenen Infrastruktur.

Wie sichere ich meine Daten und stelle sie wieder her?

Im Verzeichnis ivly. Das legt eine couchdb-backup-<zeitstempel>.tar.gz in backups/ ab.

bash

make backup

Stoppt den Stack und ersetzt alle aktuellen Daten durch das Backup.

 bash
 
 
make restore BACKUP_FILE=backups/couchdb-backup-20260329-141500.tar.gz
make up

Wie aktualisiere ich ivly?

Vorher lohnt ein Blick in den Changelog.

 bash
 
cd ivly && make backup

Im Verzeichnis, in dem ivly liegt. Er ersetzt die Stack-Dateien und behält die .env.

 bash
 
cd .. && curl -sSL https://codeberg.org/ivly/ivly-release/raw/branch/main/install.sh | sh

 bash
 
cd ivly && make pull && make up

Kann ich mein eigenes Briefpapier nutzen?

Ja. ivly bringt ein Standard-Briefpapier mit, eigene PDFs ersetzen es: eins für die erste Seite mit Kopf, eins für die Folgeseiten ohne Kopf. Zwei ODT-Vorlagen dienen als Ausgangspunkt.

bash

curl -LO https://codeberg.org/api/packages/ivly/generic/letterhead-example/latest/letterhead-example-latest.tar.gz
tar xzf letterhead-example-latest.tar.gz

letterhead.odt (erste Seite) und letterhead_noheader.odt (Folgeseiten) bearbeiten, etwa in LibreOffice, und jeweils als PDF exportieren.

Im Backoffice unter Einstellungen > Briefpapier.

Für vorgedrucktes Papier lässt sich das PDF auch ohne Briefpapier-Hintergrund drucken.

Wer entwickelt ivly?

Derzeit ich, Kevin Horst. Fehlerberichte, Ideen und Patches sind auf Codeberg willkommen.

Was bedeuten die Lizenzen?

Die ivly-Komponenten (Backoffice, API, Printer, Validation) stehen unter der AGPL-3.0. ivly darf kostenlos genutzt werden, auch geschäftlich, und darf untersucht und verändert werden. Wer eine veränderte Version anderen über ein Netzwerk anbietet, muss deren Quellcode unter derselben Lizenz veröffentlichen. Die mit ivly erstellten Rechnungen gehören dir und sind von der Lizenz nicht betroffen.

Die PDF-Bibliothek gobl.latex steht unter der Apache-2.0 und darf auch in Closed-Source-Software verwendet werden.

Ist ivly wirklich kostenlos?

Ja. ivly ist Open Source unter der AGPL-3.0 und kostet nichts. Die Weiterentwicklung kostet allerdings Zeit. Wenn ivly dir Arbeit spart, hilft eine Spende:

Funktionen

Mon, 01 Jan 0001 00:00:00 +0000

E-Rechnung

Funktion	Beschreibung
XRechnung	CII-XML nach EN 16931 und der deutschen CIUS.
ZUGFeRD / Factur-X	PDF/A-3 mit eingebettetem E-Rechnungs-XML.
Validierung	Jede Rechnung samt XML wird vor dem Ausstellen geprüft.
Anhänge (rechnungsbegründende Unterlagen)	Stundenzettel oder Lieferscheine (PDF, PNG, JPEG, CSV, XLSX, ODS) werden in XML und PDF eingebettet, auf Wunsch auch als Seiten angehängt.
GOBL	Alle Geschäftsdaten liegen als GOBL-Dokumente vor.

Rechnungen

Funktion	Beschreibung
Entwurf und Ausstellung	Die Rechnungsnummer wird erst nach bestandener Prüfung vergeben. Abgelehnte Rechnungen hinterlassen keine Lücken im Nummernkreis.
Festgeschriebene Belege	Ausgestellte Rechnungen werden als XML und PDF gespeichert und immer aus diesen Dateien ausgeliefert.
Storno	Das Stornieren einer ausgestellten Rechnung erzeugt eine Gutschrift.
Leistungsdatum	Pro Position als Datum oder Zeitraum. Der Steuersatz richtet sich nach dem Leistungsdatum, unplausible Angaben erzeugen einen Hinweis.
Briefpapier	Eigenes Briefpapier als PDF-Hintergrund, oder ohne für vorgedrucktes Papier. ODT-Vorlagen liegen bei.
Bankverbindungen	Beliebig viele in der E-Rechnung, die ersten beiden im PDF.

Stammdaten

Funktion	Beschreibung
Kunden	Inklusive Käuferreferenz (BT-10), etwa die Leitweg-ID für öffentliche Auftraggeber.
Produkte	Leistungen und Produkte mit Einzelpreis, Einheit und Steuersatz.
Firmendaten	USt-IdNr., Steuernummer und Handelsregistereintrag.
Steuersatz-Historie	Regel- und ermäßigter Steuersatz mit Gültigkeitszeitraum, etwa die befristeten 16 % und 5 % im zweiten Halbjahr 2020. Jede Rechnung nutzt den Satz, der zum Leistungsdatum galt.
Nummernkreise	Muster für Rechnungs-, Gutschrift-, Kunden- und Produktnummern, auf Wunsch jährlich oder monatlich neu beginnend.

Auswertung und Export

Funktion	Beschreibung
Dashboard	Rechnungen nach Status und Umsatz pro Monat.
DATEV-Export	Rechnungen eines Zeitraums als DATEV-CSV.

Betrieb

Funktion	Beschreibung
Self-hosted	Container-Stack für Podman oder Docker auf amd64 und arm64. Vom Notebook bis zum privaten Server, die Daten bleiben auf der eigenen Infrastruktur.
Ansible-Rolle	Automatisierte Installation auf Servern, ivly läuft dann als systemd-Dienst (Podman Quadlet), etwa auf einem Raspberry Pi.
HTTPS	Automatische Zertifikate über Caddy und Let’s Encrypt.
Backup	Sichern und Wiederherstellen der Datenbank mit je einem Befehl.
KI-Assistent (optional)	Daten in natürlicher Sprache anlegen und abfragen, lokal über Ollama.
Zugriffsschutz	Kein eingebauter Login. Der Zugriff wird am Reverse Proxy geschützt, etwa per Basic Auth oder mTLS.
Open Source	AGPL-3.0, Quellcode auf Codeberg.

Showcase

Mon, 01 Jan 0001 00:00:00 +0000

Überblick

Das Dashboard zeigt Umsatz, offene und überfällige Rechnungen, Entwürfe und die letzten Rechnungen. Kunden, Produkte und Rechnungen haben jeweils eine eigene Liste.

Dashboard mit Kennzahlen, Rechnungen pro Jahr und Umsatzverlauf.

Alle Rechnungen mit Statusfilter und DATEV-Export.

Rechnung schreiben

Kunde wählen, Positionen aus den Produkten oder als Freitext anlegen, das Leistungsdatum pro Position setzen. Stundenzettel oder Lieferscheine kommen als Belege mit.

ivly

FAQ

Backup anlegen

Wiederherstellen

Backup anlegen

Installer erneut ausführen

Images laden und starten

Vorlagen herunterladen

Anpassen und exportieren

Hochladen

Funktionen

E-Rechnung

Rechnungen

Stammdaten

Auswertung und Export

Betrieb

Showcase

Überblick

Rechnung schreiben