Ga naar inhoud

Stap 3 – Umbrel aansluiten en installeren

Doel: de Umbrel draait, je hebt een account en de nieuwste updates. Tijd: 30–45 minuten.

3.1 Aansluiten

  1. Sluit de Umbrel met een netwerkkabel aan op je router of switch.
  2. Sluit de stroom aan. Wacht ±5 minuten (de eerste start duurt langer).

3.2 Eerste keer openen

  1. Ga op een computer in hetzelfde netwerk naar: http://umbrel.local
  2. Werkt dat niet? Zoek in je router de lijst met apparaten en open http://<ip-van-umbrel>. Zie je routerkaart.
  3. Volg de installatiewizard:
  4. Kies een naam en een sterk, uniek wachtwoord. Bewaar dat in een wachtwoordmanager.
  5. Heb je een back-up van een eerdere Umbrel? Dan kun je hier herstellen. Bij een nieuwe installatie sla je dat over.
  6. Zet tweestapsverificatie (2FA) aan: Instellingen → Account / 2FA. ⚠️ Te controleren de precieze menunaam in jouw umbrelOS-versie.

3.3 Bijwerken

  • Instellingen → Software update (of vergelijkbaar) → installeer de nieuwste umbrelOS-versie.
  • Laat de Umbrel na de update rustig herstarten. Haal tijdens een update nooit de stroom eraf.

3.4 Terminal (heb je later nodig)

Voor een paar stappen in deze gids heb je een terminal op de Umbrel nodig. Je hebt twee mogelijkheden:

  • Ingebouwd: Instellingen → Geavanceerd → Terminal (umbrelOS). ⚠️ Te controleren de locatie in umbrelOS 2.x.
  • Via SSH vanaf je computer: ssh umbrel@umbrel.local (wachtwoord = je Umbrel-wachtwoord). Zie bijlage SSH-sleutel hieronder.

✅ Controlepunt: je ziet het Umbrel-dashboard, het systeem is up-to-date en 2FA staat aan.

Bijlage: inloggen zonder wachtwoord (optioneel)

Alleen handig als je vaak via SSH werkt. Op Mac/Linux (op Windows werkt dit in PowerShell vrijwel hetzelfde):

# 1. Sleutelpaar maken op je eigen computer (een wachtwoordzin is aan te raden)
ssh-keygen -t ed25519 -f ~/.ssh/id_umbrel -C "toegang umbrel"

# 2. Publieke sleutel naar de Umbrel kopiëren (eenmalig je Umbrel-wachtwoord invullen)
ssh-copy-id -i ~/.ssh/id_umbrel.pub umbrel@umbrel.local

Voeg daarna aan ~/.ssh/config toe:

Host umbrel
    HostName umbrel.local
    User umbrel
    IdentityFile ~/.ssh/id_umbrel

Zet de rechten goed met chmod 600 ~/.ssh/config en test met ssh umbrel. Windows: ssh-copy-id bestaat niet standaard. ⚠️ Te controleren kopieer de inhoud van id_umbrel.pub handmatig naar ~/.ssh/authorized_keys op de Umbrel.

🛑 Je privésleutel (id_umbrel, zonder .pub) deel je met niemand, ook niet met de Hulplijn.

➡️ Volgende: Stap 4 – Vast IP-adres