Tilari Benutzerhandbuch · Buchhaltung im Browser

Was Tilari ist

Tilari ist ein Buchhaltungsprogramm, das Sie im Browser nutzen. Sie buchen Ausgaben, Einnahmen und Umbuchungen, hängen Belege an, blättern in Bilanz und Gewinn- und Verlustrechnung und machen den Jahresabschluss. Die Bücher leben in einer Datei oder einem Schließfach, das Sie steuern — nicht in einem Tilari-Cloud-Konto.

Sie brauchen Kitsas nicht, um Tilari zu nutzen. Sie können im Browser ein neues finnisches Unternehmensbuch anlegen und die Bücher von dort führen.

Wenn Sie bereits Desktop-Kitsas nutzen (Buchhaltung mit offenem Quellcode), öffnet und speichert diese Version dieselbe .kitsas-Datei. Die Datei kann zwischen beiden wechseln; eine spätere Tilari kann davon abweichen. Tilari ist kein Produkt von Kitsas Oy, und Kitsas Oy unterstützt es nicht.

Fangen Sie mit einem Versuch an: Tilari öffnen, Buch anlegen, Beleg buchen. Darunter steht, was das Programm tut und für wen. Die Arbeitsweisen (HTML, dieser Rechner, ein Schließfach) kommen weiter unten auf der Seite.

Warum Tilari

  • Jetzt ausprobieren: eine HTML-Datei — beim Start legen Sie ein neues Buch an.
  • Vollständig im Browser — oder als normale Web-App.
  • Berichte, in denen Sie zum Beleg durchklicken; Änderungsprotokoll in der Sitzung.
  • Jahresabschluss ist möglich. Archiv gibt es noch nicht.
  • Das Buch in Ihrer Datei oder Ihrem eigenen Schließfach (Supabase / VPS).

Was Tilari hinzufügt

Tilari ist volle Buchhaltung im Browser, kein reiner Betrachter. Für die Alltagsarbeit bringt es Dinge, die Desktop-Programme selten an derselben Stelle bündeln — nützlich auch, wenn Sie Kitsas nie genutzt haben.

Wenn Sie Kitsas schon kennen: das sind Dinge, die Desktop-Kitsas nicht in derselben Form zeigt. Desktop-Kitsas bleibt die Referenz für das, was Tilari noch nicht kopiert hat (Verein und Wohnungsaktiengesellschaft, Kontenplan-Editor, Archiv). In dieser Version funktioniert dieselbe .kitsas-Datei in beiden.

Für wen

Tilari ist nützlich für jede Person, die finnische doppelte Buchhaltung selbst führen will: Freiberufler, Einzelunternehmen, kleine Kapitalgesellschaft oder Buchhalter, die einen Browser statt eines eigenen Desktop-Programms wollen. Sie brauchen keinen Kitsas-Hintergrund — ein neues Unternehmensbuch entsteht beim Start.

Es ist besonders natürlich, wenn Sie Kitsas schon kennen: dieselbe Datei, dieselben Buchungsregeln, eine Browser-Oberfläche und Tilaris eigene Sichten (Zeit, Durchklick-Berichte, Änderungsprotokoll).

Der Autor hat Tilari im eigenen Gebrauch getestet: eine finnische Osakeyhtiö (Kapitalgesellschaft, vergleichbar einer GmbH) mit relativ wenigen Belegen (typisch für Freiberufler). Große Bücher, Verein, Wohnungsaktiengesellschaft, Einzelunternehmen und andere USt-Setups wurden nicht im Alltag getestet. Die Datei öffnet sich wahrscheinlich; das Verhalten dort ist nicht garantiert. Sagen Sie Bescheid, wenn Sie Tilari in einem anderen Buch nutzen — das hilft bei der Priorität.

Was enthalten ist und was nicht

Für die Alltagsbuchhaltung reicht meist: Buch öffnen oder anlegen, Ausgabe / Einnahme / Umbuchung buchen, Beleg anhängen, Berichte lesen und den Jahresabschluss machen. Die Tabelle gilt für diese Version. Es gibt keinen veröffentlichten Zeitplan — fragen Sie in GitHub Discussions.

Bereich Status Hinweis
Bestehende .kitsas öffnen Enthalten
Ein neues leeres Buch anlegen Enthalten Beim Start. Unternehmenskontenplan: Name, Handelsregisternummer, erstes Geschäftsjahr, USt, Übung. Verein und Wohnungsaktiengesellschaft starten weiterhin in Desktop-Kitsas
Ausgabe / Einnahme / Umbuchung / Sonstiges Enthalten Tägliche Buchung
Kontoauszug Teilweise Zeile bearbeiten und auf einen eigenen Beleg aufteilen. Kein Bankdatei-Import
Anlagen Teilweise Hochladen und Vorschau. Keine OCR/Auswertung, keine automatische Verkleinerung
Kontenplan Noch nicht Konten werden aus der Datei gelesen; kein Editor
Umsatzsteuer Teilweise HTML-Erklärung; keine Übermittlung an OmaVero
Jahresabschluss Enthalten
Archiv Noch nicht
Fakturierung / Freigabelauf / Lohn Noch nicht

Funktionen anfragen

Tilari wächst danach, was wirklich genutzt wird. Wenn Sie eine Funktion vermissen (etwas Vertrautes aus Kitsas oder eine neue Idee), öffnen Sie einen Thread in GitHub Discussions. Sie brauchen keinen Kitsas-Hintergrund: sagen Sie, was die Alltagsbuchhaltung braucht.

Merken

Setup wählen

Das Buch öffnet sich immer im Browser. Wählen Sie, wo die Datei liegt und wer sie nutzt.

Sie möchten Verwenden
Test, USB-Stick, keine Installation Eine HTML-Datei
Tägliche Buchhaltung auf einem Rechner Lokaler Server und Browser
Dasselbe Schließfach zu Hause, im Büro oder am Telefon, ohne öffentliche URL Server im VPN
Das Buch in einem eigenen Supabase-Projekt Supabase-Schließfach
Eine .kitsas-Datei in Dropbox oder Drive Synchronisierter Ordner (Desktop: Chrome/Edge)
Einen öffentlichen Hostnamen und ein Anmeldetor Eigener VPS; diese Seite ersetzt nicht die Admin-Installation

In jedem Setup öffnet sich das Buch im Browser. Standard ist In diesem Browser: die Berechnung läuft auf Ihrem Gerät. Auf dem Server erscheint nur, wenn ein Tilari-Server läuft (nicht mit einem Supabase-Schließfach).

Zwei Verarbeitungsmodi

Nutzen Sie Tilari als normale Web-App (jede Aktion ist eine Anfrage an den Server) oder arbeiten Sie lokal im Tab und speichern Sie, wenn Sie wollen. Die Oberfläche läuft immer im Browser. Wenn ein Tilari-Node-Backend verbunden ist, fragt das Öffnen:

Ohne Node-Backend (eine HTML-Datei, diese Site, ein Supabase-Schließfach) gibt es nur In diesem Browser. Das Schließfach (wo die Datei liegt) ist nicht dasselbe wie der Verarbeitungsmodus: Sie können das Buch im Server-Schließfach halten und trotzdem im Tab verarbeiten.

In diesem Browser (Client) Auf dem Server
Vorteile Das Buch wird nur in diesem Tab interpretiert. Mehrere Tabs oder Personen können Bücher öffnen (Speichern ins Schließfach nutzt ETag-Konflikte). Sobald die Datei im Tab ist, kann die Arbeit weitergehen, wenn das Netz abbricht. Ein Node-Neustart löscht die Arbeitskopie nicht. Ein schweres Buch auf einem schwachen Telefon: SQLite wandert auf den Host. Dieselben Buchungsregeln wie im Browser. Erneutes Öffnen kann schneller sein, solange der Prozess noch eine Sitzung hat.
Nachteile Ein großes Buch auf einem schwachen Gerät kann langsam sein. Das ganze Buch wird in den Browser geladen. Ungespeicherte Änderungen leben in diesem Tab, bis Sie speichern. Ein offenes Buch pro Serverprozess. Ein zweites Öffnen ersetzt das erste — kein Mehrbenutzerbetrieb. Jede Aktion braucht das Netz. Ein Neustart löscht die Sitzung. Der Server sieht die Buchhaltung. Nicht verfügbar mit einem Supabase-Schließfach.

Für die Alltagsarbeit und ein geteiltes Schließfach: behalten Sie In diesem Browser. Auf dem Server ist für eine Bedienung auf einem privaten Host, wenn das Buch für das Gerät zu schwer ist.

Eine HTML-Datei

Dasselbe Programm als eine Datei (etwa 1,7 MB). Auf dieser Site ist sie tilari.htmlhier öffnen. Sie können die Datei auch speichern und offline öffnen.

Unter dieser URL (https)

Der Browser behandelt die Seite als sicheren Kontext: die Arbeitskopie überlebt ein Neuladen, Chrome/Edge kann an Ort und Stelle speichern, und optionaler BYO-Speicher funktioniert, wenn Sie Ihr Supabase oder ein Tilari-Schließfach auf Ihrem VPS verbinden (CORS muss diesen Origin erlauben). Die Tilari-Website hostet keine Bücher: die Datei wird an keinen Server gesendet, den Sie nicht selbst angeben. Es gibt keinen Node auf demselben Origin, daher kein Auf dem Server-Rechnen.

Eine Datei auf dem Datenträger (USB, E-Mail)

  1. Speichern Sie tilari.html und doppelklicken Sie sie.
  2. Wählen Sie Neue Datei wählen… und eine .kitsas.
  3. Speichern mit Speichern unter… — der Browser lädt eine neue Datei herunter.

Unter file:// stirbt die Arbeitskopie meist beim Neuladen, Überschreiben an Ort und Stelle schlägt fehl, und Sie sollten der Verschlüsselung (Supabase) nicht vertrauen. Gut für eine Demo. Für echte Bücher nutzen Sie die lokale Installation oder die https-Kopie.

Server und Client auf diesem Rechner

Das übliche Setup für eine Maschine: das Tilariprogramm (AppImage, Tilari.exe, Tilari.app oder ein lokaler Server, den die Administration startet) öffnet einen Browser unter http://127.0.0.1:8000.

Welcher Vorteil gegenüber einer einzelnen HTML-Datei?

Eine HTML-Datei Server auf diesem Rechner
Änderungen überleben ein Neuladen der Seite Nein Ja (Arbeitskopie im Browser)
In die geöffnete Datei speichern Selten Ja, auf Chrome/Edge am Desktop
Bücher in einem Tilari-Schließfach auf dieser Maschine Nein Ja (Aus eigenem Speicher öffnen…)
Schweres Buch: auf dem Server verarbeiten Nein Ja, wenn Sie Auf dem Server wählen
Dasselbe Buch vom Telefon im selben WLAN Nein Ja, wenn der Server im LAN lauscht
Installation Eine Datei Ein Programmpaket

So gehen Sie vor

  1. Starten Sie Tilari. Ein Browser-Tab öffnet sich von selbst.
  2. Öffnen Sie ein Buch von der Platte (Neue Datei wählen…) oder aus dem Schließfach (Aus eigenem Speicher öffnen…).
  3. Auf Chrome oder Edge am Desktop schreibt Speichern dieselbe .kitsas, wenn die Datei verknüpft ist. In anderen Browsern nutzen Sie Speichern unter….

Beenden Sie Desktop-Kitsas, bevor Sie dieselbe Datei in Tilari öffnen. Kitsas hält eine exklusive Sperre.

Server und Client im VPN

Dasselbe Programm wie auf Ihrem Rechner, auf einer Maschine im VPN (Tailscale, WireGuard, Firmen-VPN). Andere VPN-Geräte öffnen die Adresse im Browser, zum Beispiel http://100.x.x.x:8000. Eine öffentliche Website brauchen Sie nicht.

Tilari hat keine Benutzerkonten. Jede Person, die die Adresse erreicht, sieht die Bücher im Schließfach und kann darin speichern. Die VPN-Mitgliedschaft ist die Zugangskontrolle. Teilen Sie die Adresse nicht im offenen WLAN.

Für die Person, die installiert

  1. Installieren Sie Tilari auf einer Maschine, die anbleibt (NAS, Heimserver, Büro-PC).
  2. Nehmen Sie diese Maschine in dasselbe VPN wie die Nutzergeräte.
  3. Starten Sie den Server so, dass er auf der VPN-Adresse lauscht (LAN-Bindung, z. B. --lan, gibt TILARI_LAN_URL= aus).
  4. Öffnen Sie diese URL auf den anderen Geräten. Bücher liegen im Schließfach dieser Maschine; speichern Sie mit Auf den Server speichern.

Wenn zwei Personen dasselbe Buch gleichzeitig bearbeiten, kann das zweite Speichern abgelehnt werden („die Datei hat sich geändert“). Nutzen Sie dann Auf den Server speichern unter… statt die Arbeit der anderen zu überschreiben.

Auf dem Server-Verarbeitung hält ein Buch für eine Bedienung offen. Im Büro behalten Sie den Standard In diesem Browser und teilen über das Schließfach.

Eigener VPS

Ein öffentlicher Hostname und ein Anmeldetor. Der Server hält Bücher in einem Schließfach. Nutzen Sie Tilari als normale Web-App, oder verarbeiten Sie das Buch im Browser und speichern Sie ins Schließfach. Die Installation ist Sache der Administration; diese Seite ersetzt das nicht.

Welche Browser die Datei an Ort und Stelle speichern

Speichern in der Kopfzeile versucht, denselben Pfad zu schreiben, den Sie geöffnet haben. Das funktioniert nur in manchen Browsern, und nur wenn die Seite https:// oder localhost ist (nicht eine einzelne HTML-Datei).

Browser Geöffnete Datei überschreiben In der Praxis
Chrome, Edge, Opera, Brave (Windows, macOS, Linux) Ja Neue Datei wählen… verknüpft die Datei. Speichern aktualisiert sie. Ein Dropbox-Ordner funktioniert, wenn er ein echtes Verzeichnis auf der Platte ist.
Firefox Nein Die Arbeitskopie im Browser überlebt. Auf der Platte nutzen Sie Speichern unter….
Safari (Mac, iPhone, iPad) Nein Wie Firefox: eine Kopie herunterladen.
Chrome auf Android Nicht zuverlässig Öffnen Sie aus Dropbox oder Drive mit dem Android-Dokumentwähler. Speichern ist eine Kopie (Downloads oder „Speichern unter“).
iPhone / iPad, andere Browser Nein Teilen oder Speichern unter…. Ein Schließfach (VPN oder Supabase) ist oft einfacher.

Wenn der Browser nicht an Ort und Stelle schreiben kann, sagt das Menü, Sie sollen Speichern unter… nutzen. Sie können auch Originaldatei verknüpfen…, wenn die API existiert, das Buch aber ohne Schreibrecht geöffnet wurde.

Supabase als Schließfach

Sie können Bücher in einem eigenen Supabase-Projekt halten. Sie brauchen keinen Tilari-Server: öffnen Sie Tilari von einem statischen Host (oder einer lokalen Installation) und verbinden Sie das Schließfach im Browser. Die Verarbeitung bleibt In diesem Browser. Auf dem Server wird nicht angeboten.

Einmalige Einrichtung (Supabase-Konsole)

  1. Erstellen Sie ein Projekt auf supabase.com und öffnen Sie Project Settings → API.
  2. Kopieren Sie die Project URL und den anon public-Schlüssel. Fügen Sie niemals den service_role-Schlüssel in Tilari ein — der Schlüssel ist nur für ein Backend.
  3. In Storage erstellen Sie einen privaten Bucket namens tilari (kein öffentliches CDN).
  4. Storage-Richtlinien (RLS) auf diesem Bucket für das Präfix tilari/ (anon-Rolle, select / insert / update / delete).
  5. Storage CORS: der Tilari-https-Origin, Methoden GET, POST, PUT, DELETE, Header authorization, apikey, content-type, x-upsert. Eine file://-HTML-Datei funktioniert nicht zuverlässig.

Beispiel-RLS-Richtlinien:

create policy "tilari_locker_select"
  on storage.objects for select to anon
  using (bucket_id = 'tilari' and name like 'tilari/%');
create policy "tilari_locker_insert"
  on storage.objects for insert to anon
  with check (bucket_id = 'tilari' and name like 'tilari/%');
create policy "tilari_locker_update"
  on storage.objects for update to anon
  using (bucket_id = 'tilari' and name like 'tilari/%');
create policy "tilari_locker_delete"
  on storage.objects for delete to anon
  using (bucket_id = 'tilari' and name like 'tilari/%');

In Tilari verbinden

  1. Aus eigenem Speicher öffnen…Eigenes Supabase (BYO).
  2. Fügen Sie Project URL, Anon-Schlüssel, Bucket (Standard tilari) und das Verschlüsselungsgeheimnis ein (mindestens 8 Zeichen). Sie können mit Erzeugen ein Geheimnis anlegen — kopieren Sie es sofort woanders hin.
  3. Verbinden. Bücher erscheinen in der Liste; speichern Sie wie sonst ins Schließfach.

Dateien werden im Browser vor dem Hochladen verschlüsselt. URL und Anon-Schlüssel öffnen den Bucket; das Geheimnis öffnet die Dateien. Ein verlorenes Geheimnis bedeutet verlorene Bücher. Die Einstellungen bleiben nur in diesem Tab; das Schließen des Tabs trennt die Verbindung.

Dropbox-Ordner und Android (Drive / Dropbox)

Desktop: gemountetes Dropbox oder Google Drive

Tilari hat keine Dropbox- oder Drive-Anmeldung. Nutzen Sie den Ordner, den der Desktop-Client auf die Platte synchronisiert.

  1. Installieren Sie Dropbox oder Google Drive so, dass das Buch ein echter Ordner auf der Maschine ist.
  2. Öffnen Sie das Buch mit Chrome oder Edge aus diesem Ordner, damit Speichern dieselbe Datei schreibt.
  3. Der Hersteller-Client lädt die neuen Bytes auf andere Geräte.

Firefox und Safari laden eine Kopie herunter: legen Sie sie selbst in den synchronisierten Ordner zurück, sonst entstehen parallele Dateien. Lassen Sie Desktop-Kitsas nicht auf demselben Pfad offen. Wenn zwei Personen gleichzeitig speichern, behält die Cloud den letzten Schreibvorgang — Tilaris Schließfach-Konfliktwarnung gilt nicht.

Android: aus Dropbox oder Drive öffnen und speichern

Das Telefon bekommt nicht dieselbe „diesen Pfad schreiben“-Verknüpfung wie Chrome am Desktop.

Wenn dasselbe Buch ständig zwischen Telefon und PC wandert, ist ein VPN-Schließfach oder Supabase weniger fehleranfällig als der Downloads-Ordner.