ivly unterstützen

ivly ist freie Open-Source-Software. Jede Unterstützung hilft, die Entwicklung fortzuführen.

FAQ

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?
Schritt 1

Backup anlegen

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

bash
make backup
Schritt 2

Wiederherstellen

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.

Schritt 1

Backup anlegen

bash
cd ivly && make backup
Schritt 2

Installer erneut ausführen

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
Schritt 3

Images laden und starten

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.

Schritt 1

Vorlagen herunterladen

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
Schritt 2

Anpassen und exportieren

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

Schritt 3

Hochladen

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: