Version 0.1.0 · Frühe Entwicklung Source-available · PolyForm Noncommercial

Damit die Wohnung läuft, auch wenn du nicht da bist.

hauswart ist die selbst gehostete Wohnungsverwaltung für deinen Haushalt: Wartung mit Nachweis, wer was gemacht hat, Geräte und Garantien, Mängel, Ersatzteile und eine Dokumentation, mit der jemand anderes übernehmen kann.

Ein Docker-Container · SQLite · Deutsch und Englisch · keine Cloud nötig

Das hauswart-Dashboard mit überfälligen und anstehenden Aufgaben und den zuletzt erledigten Aufgaben
Das Dashboard auf einem Smartphone-Bildschirm

Alle Bildschirmfotos zeigen die deutsche Oberfläche mit erfundenen Demo-Daten.

  • Selbst gehostet

    Deine Daten liegen in einer SQLite-Datei auf deinem Server.

  • Ein Haushalt, mehrere Personen

    Alle sehen dasselbe und wissen, wer was erledigt hat.

  • Offene Schnittstellen

    REST-API mit OpenAPI-Beschreibung und ein MCP-Server.

  • Für das Handy gebaut

    Ab 360 px Breite, mit dunklem Modus und QR-Codes an den Geräten.

Funktionen

Alles, was eine Wohnung am Laufen hält

Von der Filterwechsel-Erinnerung bis zur Übergabe-Mappe für die Vertretung: ein Ort statt Zettel, Chatverläufe und Gedächtnis.

Wartung mit Nachweis

Aufgaben, die sich selbst erinnern

Jede Aufgabe hat einen Rhythmus, der zur Wohnung passt, und hält fest, wer sie erledigt hat. Eine Erledigung ist ein Nachweis mit Datum, Person und Notiz. Ein Versehen machst du in den ersten sieben Tagen rückgängig.

  • Überfällig, heute, diese Woche: das Dashboard sortiert nach Dringlichkeit
  • Putzen und Kehricht im Wechsel, fair nach Aufwand verteilt
  • Vorbereitungen mit Vorlauf, etwa den Ersatzfilter rechtzeitig bestellen
Aufgabenliste mit einer überfälligen und mehreren offenen Aufgaben, Erledigt-Schaltflächen und zugewiesenen Personen
Rhythmus-Editor

Der Rhythmus, vorgerechnet bevor du speicherst

Intervalle, Mindesthäufigkeiten, Kalender, Saisons und Zähler lassen sich kombinieren. Die Vorschau formuliert den Rhythmus in einem Satz und zeigt, wann die Aufgabe das nächste Mal fällig wird.

Aufgaben-Editor mit Intervall und Jahreszeiten und rechts der Vorschau «Alle 14 Tage ab letzter Erledigung; April bis September: alle 7 Tage»

Beispiele aus dem Alltag

  • Mückennetz-Rollo

    Mindestens einmal pro Monat kontrollieren und abstauben.

  • Flusensieb der Waschmaschine

    Alle 5 Waschgänge, gezählt über einen Zähler in Home Assistant.

  • Lüftungsfilter

    Alle 6 Monate wechseln. Der Ersatz wird 3 Wochen vorher zum Bestellen angezeigt.

  • Aktivkohlefilter der Dunstabzugshaube

    Alle 3 Monate ersetzen, mit Ersatzteil und Lagerbestand verknüpft.

  • Pflanzen giessen

    Im Sommer alle 7 Tage, im Winter alle 14 Tage.

  • Putzen und Kehricht

    Wöchentlich im Wechsel. Die Abfuhrdaten kommen aus einem Kalender.

  • Geschirrspüler mit 75 °C

    Einmal pro Woche leer laufen lassen, damit Filter und Dichtungen sauber bleiben.

  • Hausregeln und Pflegehinweise

    Jedes Gerät trägt Regeln, Tipps und Warnungen, die beim Gerät angezeigt werden.

Geräte und Garantien

Jedes Gerät hat eine Seite

Eckdaten, Garantie-Ampel, Pflegehinweise, Kontakte zum Kundendienst, Ersatzteile und die Servicehistorie an einem Ort. Ein QR-Code zum Aufkleben führt direkt dorthin. Derselbe Link lässt sich auch auf einen NFC-Tag schreiben.

  • Garantie: gültig, läuft in 90 Tagen ab oder abgelaufen
  • Pflegehinweise als Regel, Tipp oder Warnung, auch mit Foto
  • Kontakte mit Rolle: Support, Installateur, Verkäufer, Service
Geräteseite eines Geschirrspülers mit Pflegehinweisen als Regel, Tipp und Warnung und einem QR-Code
Garantien-Übersicht als Tabelle mit Ampel: gültig, läuft in 90 Tagen ab, abgelaufen
Mängel

Vom Entdecken bis zur Behebung lückenlos

Erfasse einen Mangel mit Ort und Dringlichkeit, melde ihn der Verwaltung und verfolge ihn durch den Status-Ablauf. Die Frist wird ab dem Übergabedatum berechnet, und eine Erinnerung hält sie im Blick.

  • Verlauf mit Statuswechseln, Korrespondenz und Kommentaren
  • Zuständiger Kontakt und Frist pro Mangel
  • Mängelliste als PDF zum Weitergeben
Mangel «Risse im Silikon der Duschwanne» mit Status-Ablauf, Angaben und Verlauf
Dokumentation

Eine Mappe, mit der jemand anderes übernehmen kann

Schreibe Anleitungen und Regeln in Markdown, mit Fotos, PDFs und Hinweisboxen. Vertrauliches wie das WLAN-Passwort kommt in einen Geheim-Block, der Gästen nie angezeigt wird. Seiten verlinkst du untereinander, und die Suche findet alles.

  • Markdown mit Inhaltsverzeichnis, Versionen und Rückverweisen
  • Volltextsuche über Seiten, Geräte, Aufgaben, Mängel und Kontakte
  • Notfallblatt und Gästelinks mit PIN und Ablaufdatum
Dokumentationsseite «Übergabe für die Vertretung» mit Hinweisbox und vertraulichem Block
Ersatzteile und Bestand

«Jetzt bestellen» rechnet für dich

Verknüpfe Teile mit Geräten und Aufgaben. hauswart vergleicht Bestand, Bedarf und Lieferzeit und zeigt dir, was du bis wann bestellen musst. Eine Erledigung bucht das verbrauchte Teil automatisch aus dem Bestand.

Ersatzteile-Übersicht mit der Box «Jetzt bestellen» für einen Aktivkohlefilter und der Bestandsliste
Und noch mehr

Die Details, die den Alltag leichter machen

Push mit «Erledigt»-Taste

Über Home Assistant landet die Erinnerung auf dem Handy. Ein Tipp auf «Erledigt» verbucht die Aufgabe auf deinen Namen.

Verfügbar

Kommentare überall

Aufgaben, Geräte, Mängel, Hinweise und Seiten lassen sich kommentieren. Die anderen werden benachrichtigt.

Verfügbar

Kontakte und Servicehistorie

Wer hat den Zulaufschlauch ersetzt, und wen rufst du an? Beides steht beim Gerät.

Verfügbar

Backup und Dateien

Täglich eine konsistente Datenbankkopie plus Spiegel der hochgeladenen Dateien. Bilder werden ohne Metadaten gespeichert.

Verfügbar

Kalender-Feeds (iCal)

Fällige Aufgaben, Vorbereitungen, Mängelfristen und Garantien im eigenen Kalender abonnieren.

Verfügbar

Kosten und Verteilung

Ausgaben pro Gerät erfassen, nach Eigentumsanteilen aufteilen und abrechnen. Heute über API und MCP, die Oberfläche folgt.

Nur per API

Volltextsuche

Strg + K durchsucht Seiten, Geräte, Aufgaben, Mängel, Kontakte und Teile. Geheim-Blöcke landen nie im Suchindex.

Verfügbar

Zweisprachig, hell und dunkel

Die Oberfläche gibt es auf Deutsch und Englisch, im hellen und im dunklen Modus.

Verfügbar
Mobil

Am Handy zu Hause

Aufgabe abhaken, Ersatzteil bestellen, Pflegehinweis nachlesen: alles ist für schmale Bildschirme ab 360 px gebaut, im hellen und im dunklen Modus.

Dashboard auf dem Smartphone
Ersatzteile mit «Jetzt bestellen» auf dem Smartphone
Pflegehinweise eines Geräts auf dem Smartphone
Integrationen

Spielt mit deinem Zuhause zusammen

Alles ist optional: hauswart läuft auch ohne eine einzige Verbindung. Wo du sie einrichtest, werden Aufgaben schlauer.

  • Home Assistant

    Zähler und Zustände lesen, Aufgaben automatisch erledigen, Abfuhrdaten aus Kalendern holen und Push-Nachrichten mit «Erledigt»-Taste senden.

    Verfügbar
  • Paperless-ngx

    Belege, Handbücher und Garantiescheine an Geräte und Mängel hängen, pro Person verbunden. Heute über die API, die Oberfläche folgt.

    Nur per API
  • Kept

    Offene Rechnungen als Aufgaben und Zahlungen als Kostenvorschläge aus der selbst gehosteten Finanz-App, pro Person verbunden. Heute über die API, die Oberfläche folgt.

    Nur per API
API und KI

Alles ist per API erreichbar

Die Weboberfläche nutzt dieselbe REST-API wie Home Assistant, die geplante Mobile-App und deine eigenen Skripte. Der Vertrag ist als OpenAPI 3.1 beschrieben.

MCP-Server für Claude und Co.

Verbinde einen KI-Assistenten und frage ihn nach deiner Wohnung oder lass ihn Dinge erledigen. Die Werkzeuge sind auf Aufgaben zugeschnitten: nachschauen, erledigen, Mängel melden, Bestand buchen, kommentieren.

Registrieren, zum Beispiel in Claude Code:

Terminal
claude mcp add hauswart \
  --env HAUSWART_URL=https://hauswart.example.org \
  --env HAUSWART_TOKEN=hw_… \
  -- /path/to/hauswart-mcp

Tokens mit Berechtigungen: Mit einem reinen Lese-Token sieht ein Client gar keine Schreib-Werkzeuge.

Ein Aufruf mit Token:

$ curl -H "Authorization: Bearer hw_…" \
    https://hauswart.example.org/api/v1/dashboard
API-Referenz (OpenAPI)
Beispiel mit Demo-Daten
Was ist diese Woche fällig?
Werkzeug: Aufgaben abfragen
Überfällig ist «Waschmaschine reinigen». Diese Woche stehen an: Monstera giessen (morgen), Bad putzen und Küche putzen (Samstag) und der Geschirrspüler-Lauf mit 75 °C (Sonntag).
Bestell-Liste?
Der Aktivkohlefilter des Dampfabzugs: Bestand 0, benötigt bis Montag, 2 Stück.
Ehrlicher Stand

Frühe Entwicklung, mit solidem Fundament

Version 0.1.0 ist das erste frühe Release, kein stabiles. Der Kern steht und ist durchgetestet, aber Schnittstellen und Datenmodell können sich noch ändern. Sichere deine Daten und probiere es zuerst aus.

Funktioniert heute

  • Aufgaben mit Rhythmus-Editor, Erledigungen, Dashboard und Benachrichtigungen
  • Geräte, Räume, Pflanzen, Garantien, Pflegehinweise und QR-Codes
  • Mängel mit Status-Ablauf, Fristen und PDF-Export
  • Dokumentation, Suche, Ersatzteile, Kontakte, Servicehistorie, Kommentare
  • Home Assistant: Messwerte, Automatik, Push mit «Erledigt»-Taste
  • REST-API, OpenAPI-Beschreibung und MCP-Server
  • iCal-Feeds, Notfallblatt und Gästelinks mit PIN
Selbst hosten

In fünf Minuten läuft es

hauswart ist ein einziger Docker-Container mit SQLite. Das fertige Image liegt in der GitHub Container Registry.

  1. Starten

    Starte den Container mit dem Image. Ein Volume hält Datenbank und Dateien, der geheime Schlüssel verschlüsselt gespeicherte Zugangsdaten.

  2. Setup öffnen

    Rufe die Adresse im Browser auf. Beim ersten Besuch legst du das Administratorkonto an.

  3. Beispieldaten laden (optional)

    Erstelle unter Einstellungen einen API-Token und importiere eine Beispielwohnung, um alles auszuprobieren.

Terminal
docker run -d --name hauswart -p 3000:3000 \
  -v hauswart-data:/data \
  -e HAUSWART_SECRET_KEY="$(openssl rand -base64 32)" \
  -e ORIGIN=http://localhost:3000 \
  -e HAUSWART_COOKIE_SECURE=false \
  ghcr.io/orellbuehler/hauswart:0.1.0

Hinter einem Reverse-Proxy setzt du ORIGIN auf die öffentliche Adresse, zum Beispiel https://hauswart.example.org. Den geheimen Schlüssel musst du aufbewahren. Eine Compose-Datei sowie Hinweise zu Proxy, Updates und Backups stehen im README.

Gebaut mit BunSvelteKitSQLiteTailwind CSSDocker
FAQ

Häufige Fragen

Ist hauswart schon fertig?

Nein. Version 0.1.0 ist ein früher Stand ohne stabiles Release. Die Kernfunktionen laufen, anderes fehlt noch, siehe «Ehrlicher Stand». Rechne damit, dass sich Schnittstellen und Datenmodell noch ändern.

Brauche ich Home Assistant?

Nein. Home Assistant, Paperless-ngx und Kept sind optionale Anbindungen. Ohne Home Assistant funktionieren Aufgaben mit festen Rhythmen, Dokumentation, Geräte und Mängel wie gewohnt. Nur zähler- und zustandsbasierte Auslöser brauchen Messwerte.

Für wie viele Haushalte ist es gedacht?

Für genau einen Haushalt mit einigen Personen. Alle Wohnungsdaten sind für alle Konten gemeinsam. Nur Sitzungen, API-Tokens, Verbindungen und persönliche Einstellungen gehören einer einzelnen Person.

Wo liegen meine Daten?

In einer SQLite-Datei und einem Ordner für hochgeladene Dateien, beide im Docker-Volume auf deinem Server. Täglich entsteht ein Backup, und hauswart sendet keine Nutzungsdaten an Dritte.

Unter welcher Lizenz steht es?

Unter der PolyForm Noncommercial License 1.0.0. Privat und für andere nicht-kommerzielle Zwecke ist die Nutzung frei. Der Quellcode ist einsehbar, die Lizenz ist aber keine OSI-Open-Source-Lizenz.

Gibt es eine Mobile-App?

Noch nicht. Die REST-API ist dafür vorbereitet, und die Weboberfläche funktioniert ab 360 px Breite gut auf dem Handy.

Kann ich einen KI-Assistenten anbinden?

Ja, über den mitgelieferten MCP-Server. Du legst einen Token mit den gewünschten Berechtigungen an, und der Assistent sieht nur die Werkzeuge, die dazu passen.

Probiere hauswart in deiner Wohnung aus

Frühe Entwicklung heisst: Rückmeldungen sind besonders wertvoll. Schau dir den Code an, starte den Container und erzähl, was fehlt.