homelab-infra/docs/FAMILY_ONBOARDING.md

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.

---

Onboarding-Checkliste fuer Michi

Diese Punkte gehoeren in das erste echte Familien-Onboarding. Keine Secret-Werte in diese Datei schreiben.

Status	Aufgabe
offen	Pro Familienmitglied Konto/Start-Passwort persoenlich uebergeben
offen	Vaultwarden/Bitwarden-App auf Handy einrichten
offen	Testeintrag in Vaultwarden anlegen
offen	Immich-App auf jedem Familien-Handy einrichten
offen	Immich-Backup mit ersten Fotos sichtbar pruefen
offen	Mealie mit erstem Rezept und Einkaufsliste praktisch ausprobieren
offen	Danach entscheiden, ob Nextcloud/Paperless/Plex direkt mitkommen oder spaeter

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.