homelab-infra/docs/FAMILY_ONBOARDING.md

Familien-Willkommen - KalliLab CORE

Status: Final-Stand vor Wochenend-Einladung (2026-05-27). 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.

---

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. 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.

---

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.

---

Offene Inhalte (Operator-Notiz)

Diese Punkte gehoeren in das Wochenend-Onboarding-Gespraech und sind nicht Teil dieser Familien-Seite:

Status	Aufgabe
offen	Pro Familien-Konto Benutzernamen und Start-Passwort persoenlich uebergeben (Vaultwarden Familien-Organisation als Uebergabeweg)
offen	2FA-App-Empfehlung pro Person festlegen (zum Beispiel Bitwarden Authenticator, Aegis, 2FAS)
offen	Vaultwarden Familien-Organisation einrichten und Mitglieder einladen
offen	Immich Mobile Backup mit jedem Familien-Geraet einmal gemeinsam ausprobieren
offen	Scan-/Inbox-Anleitung fuer Paperless ergaenzen, sobald der Workflow final ist
offen	Einladungstermin Wochenende mit konkretem Datum festlegen

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.