Micha/homelab-infra
1
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
Files
207f49f00126e8a3d47ca3feebbf9a1d62c51c76
homelab-infra/docs/FAMILY_ONBOARDING.md
T

13 KiB
Raw Blame History

Familien-Willkommen - KalliLab CORE

Status: Praxis-Onboarding (2026-06-01). Zielgruppe: Familie. Kein Technik-Wortschatz noetig.

Diese Seite richtet sich an alle, die zuhause unsere eigenen Apps nutzen. Du brauchst kein Technikwissen. Wenn etwas unklar ist: einfach Michi fragen.

Du musst nichts auswendig lernen. Wenn du nur eine Sache aus dieser Seite mitnimmst: Passwoerter gehoeren in Vaultwarden, nicht auf Zettel und nicht in den Browser.

Was wir zuhause selbst betreiben

Wir haben einen eigenen kleinen Server im Haus. Auf dem laufen ein paar Programme, die wir alle gemeinsam nutzen koennen, statt sie bei Google, Apple oder Dropbox liegen zu haben. Vorteile: Unsere Fotos und Dokumente bleiben bei uns. Wir entscheiden, wer was sehen darf. Es kostet uns kein Abo.

Nachteile, ehrlich gesagt: Wenn der Server zuhause aus ist, sind die Apps weg, bis er wieder laeuft. Das passiert selten — meistens nur, wenn Michi etwas umbaut oder der Strom weg ist. Und es gibt keine Hotline, die Passwoerter zuruecksetzt. Das macht Michi.

Die Apps in einem Satz

App Was sie kann Wie du sie nutzt
Nextcloud Dateien und Ordner teilen, Kalender, Adressbuch Web cloud.kaleschke.info oder Nextcloud-App auf dem Handy
Immich Fotos und Videos automatisch vom Handy sichern, gemeinsam durchblaettern Immich-App auf dem Handy einrichten lassen
Vaultwarden Passwoerter sicher speichern und auf jedem Geraet nachschauen Bitwarden-App (kostenlos), beim ersten Start Server-URL auf vault.kaleschke.info aendern lassen
Mealie Rezepte sammeln, Wochenplan, Einkaufsliste Web mealie.kaleschke.info oder Mealie-App
Paperless Briefe und wichtige Dokumente scannen, durchsuchen, ablegen Web paperless.kaleschke.info; Scan-Workflow erklaert Michi
Plex Filme und Musik auf Fernseher, Handy und Tablet Plex-App auf dem Geraet, mit Konto anmelden

Wenn du eine App auf dem Handy installierst und sie fragt nach einer Server-URL, ist das immer eine ...kaleschke.info-Adresse. Wenn du dir nicht sicher bist, frag bevor du etwas eintippst.

Unser erster gemeinsamer Ablauf

Wir richten nicht alles auf einmal perfekt ein. Wichtig ist, dass drei Dinge wirklich benutzt werden:

  1. Vaultwarden: Passwoerter landen dort, nicht im Browser.
  2. Immich: Handy-Fotos werden automatisch gesichert.
  3. Mealie: Rezepte und Einkaufsliste werden gemeinsam ausprobiert.

Wenn diese drei Dinge laufen, ist das Familien-Onboarding praktisch erfolgreich.

Vaultwarden zuerst

Vaultwarden ist die Grundlage fuer alle anderen Logins.

  1. App Bitwarden Passwortmanager auf Handy und ggf. PC installieren.
  2. Beim ersten Start die Server-URL auf https://vault.kaleschke.info setzen.
  3. Mit dem persoenlichen Konto anmelden.
  4. Master-Passwort gemeinsam festlegen und merken. Das Master-Passwort wird nicht bei Michi gespeichert.
  5. Browser-Passwortspeicher fuer neue Homelab-Passwoerter nicht verwenden.
  6. Test: Einen neuen Eintrag "Test KalliLab" anlegen und wiederfinden.

Was in Vaultwarden gehoert:

  • Homelab-App-Passwoerter
  • wichtige Familien-Logins
  • Recovery-Codes, wenn eine App welche zeigt
  • keine losen Passwort-Zettel und keine Screenshots von Passwoertern

Wie du dich anmeldest

Beim ersten Mal bekommst du von Michi:

  • deinen Benutzernamen (in der Regel dein Vorname klein geschrieben)
  • ein Start-Passwort, das du beim ersten Login aenderst

Wenn eine App selbst einen Zweitfaktor anbietet (zum Beispiel Nextcloud), bekommst du dafuer am Anfang gemeinsam mit Michi eine kleine Authentifizierungs-App eingerichtet. Das ist eine extra Schicht: zusaetzlich zum Passwort tippst du beim Login eine 6-stellige Zahl aus dieser App ein.

Hinweis: Ein einheitliches 2FA fuer alle Apps gleichzeitig ist noch nicht eingerichtet. Aktuell hat jede App ihre eigene Anmeldung. Das bleibt erst einmal so. Wenn sich da etwas aendert, sagt Michi rechtzeitig Bescheid.

Bitte:

  • Speichere alle Passwoerter im Vaultwarden, nicht im Browser.
  • Schreibe Passwoerter nicht auf Zettel.
  • Gib dein Passwort niemandem, auch nicht "kurz mal".

Foto-Backup vom Handy einrichten (Immich)

Das ist die App, die deinen Eltern wahrscheinlich am meisten bringt.

  1. App Immich im App-Store / Play Store installieren.
  2. Beim ersten Start nach Server fragen lassen: https://immich.kaleschke.info.
  3. Mit deinem Login anmelden.
  4. In den App-Einstellungen "Hintergrund-Backup" aktivieren - am besten nur ueber WLAN.
  5. Das richtige Album / die normale Kamera-Galerie auswaehlen.
  6. App einmal offen lassen, bis erste Fotos hochgeladen wurden.
  7. Test: In der Weboberflaeche https://immich.kaleschke.info pruefen, ob die ersten Fotos sichtbar sind.
  8. Fertig. Neue Fotos landen automatisch zuhause auf dem Server.

Wenn dein Handy 4 Wochen nicht im Haus-WLAN war, sind die Fotos noch in der Handy-Galerie, aber noch nicht zuhause. Sobald du wieder im WLAN bist und die App startest, holt sie alles nach.

Rezepte und Einkaufsliste einrichten (Mealie)

Mealie soll nicht nur "auch da" sein, sondern wirklich genutzt werden.

  1. https://mealie.kaleschke.info oeffnen.
  2. Mit dem persoenlichen Konto anmelden.
  3. Gemeinsam ein erstes echtes Rezept anlegen oder importieren.
  4. Rezept mindestens einer Kategorie geben, z. B. Alltag, Schnell, Wochenende, Vegetarisch.
  5. Aus dem Rezept Zutaten auf die Einkaufsliste setzen.
  6. Test: Einkaufsliste auf dem Handy oeffnen und einen Eintrag abhaken.
  7. Optional: Einen Wochenplan fuer die naechsten 2-3 Tage anlegen.

Start-Regeln fuer Mealie:

  • Rezepte nur dann speichern, wenn wir sie wirklich kochen wuerden.
  • Namen schlicht halten: Chili, Bolognese, Kartoffelsuppe.
  • Zutaten so eintragen, dass sie beim Einkaufen verstaendlich sind.
  • Wenn ein Rezept nicht schmeckt: loeschen oder klar als "nicht wieder" markieren.

Was tun, wenn etwas nicht geht

"Die Webseite oeffnet nicht."

  1. 10 Minuten warten — Michi macht vielleicht gerade etwas am Server.
  2. Anderes Geraet ausprobieren (Handy statt PC oder umgekehrt).
  3. Wenn es danach immer noch nicht geht: Michi schreiben. Bitte schreib dazu, was du genau aufgerufen hast (cloud.kaleschke.info / immich.kaleschke.info / ...).

"Ich habe mein Passwort vergessen."

  • Nicht selbst neu registrieren. Das geht in den Apps gar nicht.
  • Michi schreiben. Er setzt dir ein neues Start-Passwort. Du aenderst es beim ersten Login.

"Ich habe mein 2FA verloren (neues Handy, App geloescht)."

  • Michi schreiben. Er kann den Zweitfaktor in der betroffenen App fuer dich zuruecksetzen, sobald er dich persoenlich identifiziert.
  • Wir richten den Zweitfaktor dann neu auf dem neuen Handy ein.
  • Wenn moeglich: vor einem Handy-Wechsel kurz Bescheid sagen, dann koennen wir 2FA vorher umziehen, statt zuruecksetzen.

"Das Handy-Foto-Backup ist stehen geblieben."

  1. Immich-App oeffnen, ist sie noch eingeloggt?
  2. Bist du im Haus-WLAN? Mobilfunk ist meistens nicht aktiviert.
  3. Akkusparmodus pruefen — wenn er aktiv ist, kann die App pausieren.
  4. App schliessen, wieder oeffnen, ein paar Minuten warten.
  5. Wenn das nicht hilft: Michi schreiben.

"Der Browser warnt vor der Seite."

  • Nicht weiterklicken.
  • Screenshot machen.
  • Michi schicken.
  • Wahrscheinlich ist gerade ein Zertifikat abgelaufen — das ist normalerweise schnell behoben, aber Michi muss kurz draufschauen.

"Mein Familien-Mitglied sagt, sein Konto sei gesperrt."

  • Manchmal sperren die Apps Konten nach mehreren falschen Passwoertern fuer ein paar Minuten. Das ist Absicht. Einfach 10 Minuten warten und nochmal versuchen.
  • Wenn es laenger dauert: Michi schreiben.

Was du nicht musst

  • Du musst nichts installieren, einrichten oder warten.
  • Du musst keine Updates pruefen.
  • Du musst nicht wissen, wo die Daten genau liegen — sie liegen auf dem Server zuhause und werden automatisch gesichert.
  • Du musst dir keine Adressen merken — alle Apps sind ueber ...kaleschke.info erreichbar und Michi schickt dir den Direktlink, wenn du einen brauchst.

Was wir uns gemeinsam wuenschen

  • Bitte nutze Vaultwarden fuer alle Familien-Passwoerter. Das schuetzt uns alle.
  • Bitte sag Bescheid, wenn etwas komisch wirkt (seltsame E-Mail, Login-Aufforderung an der falschen Stelle). Lieber einmal zu oft fragen.
  • Wenn dir eine App fehlt oder du eine Idee hast, was wir gemeinsam besser machen koennten: ansprechen, nicht selbst herumprobieren.

Wenn der Server zuhause mal komplett aus ist

Das kommt selten vor. In dem Fall:

  • Webseiten von ...kaleschke.info oeffnen nicht.
  • Foto-Backup von Immich pausiert automatisch — neue Fotos bleiben auf dem Handy und werden nachgeholt, sobald der Server wieder da ist.
  • Plex-App zeigt "Server offline" — Filme sind weiterhin da, sobald der Server zurueck ist.
  • Vaultwarden: gespeicherte Passwoerter sind weiterhin in der Bitwarden-App offline verfuegbar.
  • Es geht nichts kaputt, nur weil der Server kurz aus ist.

Michi laesst es dich wissen, wenn ein Wartungsfenster geplant ist.

Erster Onboarding-Termin - Ablauf fuer Michi

Diese Sektion ist die konkrete Checkliste fuer den ersten echten Familien-Onboarding-Termin. Sie ist als ein zusammenhaengender Termin von ca. 30-45 Minuten pro Person gedacht. Keine Secret-Werte in diese Datei schreiben.

Operator-Eingabe vor dem Termin: festlegen, wer beim ersten Termin dabei ist und welche Geraete real vorliegen. Die Checkliste funktioniert pro Person identisch.

Vorher bereitlegen (Operator-Vorbereitung)

Diese Dinge muessen vor dem Termin fertig sein, sonst stockt der Ablauf:

  • Pro Teilnehmer ist in Vaultwarden ein Benutzerkonto angelegt (Benutzername = Vorname klein).
  • Pro Teilnehmer ist in Immich ein Benutzerkonto angelegt.
  • Pro Teilnehmer ist in Mealie ein Benutzerkonto angelegt.
  • Start-Passwoerter sind erzeugt und liegen so bereit, dass sie persoenlich uebergeben werden koennen (nicht per Chat, nicht in diese Datei).
  • Die Apps cloud, immich, vault, mealie sind erreichbar (kurzer eigener Smoke-Test ueber https://...kaleschke.info).
  • Das Familien-Handy/Geraet jedes Teilnehmers ist da, entsperrt und im Haus-WLAN.
  • App-Store-/Play-Store-Login auf dem Geraet funktioniert (zum Installieren der Apps).

Reihenfolge beim Termin (pro Person)

Die Reihenfolge ist bewusst gewaehlt: erst der Passwort-Speicher, dann das, was am meisten bringt (Fotos), dann das Gemeinsame (Rezepte).

  1. Konto-Uebergabe: Benutzername + Start-Passwort persoenlich uebergeben, Person aendert das Passwort beim ersten Login.
  2. Vaultwarden / Bitwarden (Abschnitt "Vaultwarden zuerst"):
    • Bitwarden-App installieren, Server-URL https://vault.kaleschke.info setzen, anmelden.
    • Master-Passwort gemeinsam festlegen (wird nicht bei Michi gespeichert).
    • Testeintrag "Test KalliLab" anlegen und wiederfinden.
  3. Immich (Abschnitt "Foto-Backup vom Handy einrichten"):
    • Immich-App installieren, Server https://immich.kaleschke.info, anmelden.
    • Hintergrund-Backup nur ueber WLAN aktivieren, Kamera-Album auswaehlen.
    • App offen lassen, bis erste Fotos hochgeladen sind; in der Weboberflaeche sichtbar pruefen.
  4. Mealie (Abschnitt "Rezepte und Einkaufsliste einrichten"):
    • https://mealie.kaleschke.info anmelden.
    • Gemeinsam ein erstes echtes Rezept anlegen, kategorisieren, Zutaten auf die Einkaufsliste setzen.
    • Einkaufsliste auf dem Handy oeffnen und einen Eintrag abhaken.
  5. Abschluss: kurz zeigen, was bei Problemen zu tun ist (Abschnitt "Was tun, wenn etwas nicht geht"), besonders Passwort-vergessen und 2FA-verloren.

Erfolgskriterium des ersten Termins

Der Termin gilt als erfolgreich, wenn pro Person diese drei Dinge real laufen:

  • Vaultwarden ist eingerichtet und ein Testeintrag wurde gefunden.
  • Immich sichert Handy-Fotos und die ersten Fotos sind in der Weboberflaeche sichtbar.
  • In Mealie existiert ein erstes Rezept mit einer Einkaufslisten-Position.

Bewusst spaeter (nicht im ersten Termin)

Damit der erste Termin nicht ueberladen wird, kommen diese Punkte bewusst erst in einem Folgetermin:

  • Nextcloud (Dateien/Kalender/Adressbuch) - erst wenn die drei Kern-Apps sitzen.
  • Paperless (Dokumente scannen) - braucht eigenen Scan-Workflow, separater Termin.
  • Plex (Filme/Musik) - reines Komfort-Thema, kein Onboarding-Kern.
  • App-uebergreifendes Einheits-Login (SSO/OIDC) - nicht eingerichtet, nur als Idee notiert (siehe "Bewusst nicht versprochen").

Bewusst nicht versprochen

Damit niemand spaeter enttaeuscht ist, hier kurz, was die Seite nicht verspricht:

  • Es gibt aktuell kein Einheits-Login fuer alle Apps. Jede App hat ihre eigene Anmeldung. Eine Vereinheitlichung ist als Idee notiert, aber zeitlich noch nicht geplant.
  • Es gibt keine Garantie, dass eine App 24/7 verfuegbar ist. Es ist ein Heim-Server, kein Rechenzentrum.
  • Es gibt keinen automatischen Support per Hotline. Probleme gehen an Michi.
  • Es gibt kein Werbe-Konto und keinen Versand deiner Daten an Externe. Alles bleibt zuhause.
Reference in New Issue View Git Blame Copy Permalink