Problemen oplossen¶

Zoek je klacht op. Per probleem staat er symptoom → oorzaak → oplossing → controle. Staat je probleem er niet bij? Stel je vraag per e-mail (gratis). Opgeloste problemen komen hier later bij.

Snelkoppelingen: Internet weg · Thuis zwart scherm · Grote uploads mislukken · Thuis toch via Cloudflare · Tunnel down · Certificaat · Datums kwijt · rsync sudo · Community store · OnlyOffice · Pi-hole blokkeert iets · Immich-app

Internet thuis weg, of alles tegelijk offline¶

Symptoom: geen enkele website opent thuis, of router, Umbrel en wifi lijken tegelijk uit te vallen.

Werkt 4G wel, en de router heeft wel internet? Dan is het waarschijnlijk DNS (Pi-hole/Umbrel). Volg de noodkaart.
Valt alles tegelijk weg (router, switch, Umbrel)? Denk eerst aan stroom: een stekkerdoos, een losse stroomkabel of een adapter. Als het hele netwerk tegelijk uitvalt, is dat bijna altijd stroom of hardware, geen software. Controleer dat voordat je aan instellingen gaat zitten.
Rood lampje op de router? Niet meteen herstarten:
log in op de router → gebeurtenissenlogboek (filter op Internet/WAN/DHCP),
noteer de tijd en de melding,
herstart daarna (stroom 10 seconden eraf).

Een tijdelijke hapering tussen modem en router lost een herstart meestal op. De notities helpen als het vaker gebeurt.

Thuis zwart scherm of verbinding geweigerd (onderweg werkt het wel)¶

Symptoom: https://fotos.jouwdomein.nl geeft thuis "verbinding geweigerd" of een zwart scherm (vaak op iPhone). Via 4G of met een VPN werkt het wel.

Oorzaak: een update van de Nginx Proxy Manager-app heeft de HTTPS-poort teruggezet van 443 naar 40443. Thuis stuurt Pi-hole je naar poort 443 op de Umbrel, maar daar luistert niets meer.

Controle:

Mac/Linux: nc -z <umbrel-ip> 443 mislukt en nc -z <umbrel-ip> 40443 slaagt.
Windows: Test-NetConnection <umbrel-ip> -Port 443.

Oplossing:

Pas in ~/umbrel/app-data/nginx-proxy-manager/docker-compose.yml "40443:443" aan naar "443:443".
Herstart de app (Umbrel → Nginx Proxy Manager → Stoppen → Starten).
Zorg dat de pre-start-hook uit stap 13.6 bestaat en uitvoerbaar is (chmod +x). Dan gebeurt dit na een volgende update automatisch.

Grote uploads mislukken (error 413 of blijft hangen)¶

Symptoom: grote video's (>100 MB) uploaden niet. Kleine foto's wel.

Oorzaak: de upload gaat via Cloudflare, en het gratis plan accepteert maximaal 100 MB per upload (Cloudflare-documentatie).

Oplossing:

Onderweg: normaal. De Immich-app probeert het opnieuw zodra je thuis bent.
Thuis, route 1: zet Automatisch wisselen van URL aan in de Immich-app (stap 7.3). In de browser gebruik je thuis http://<umbrel-ip>:2283.
Thuis, route 2: het verkeer zou lokaal moeten gaan. Zie thuis toch via Cloudflare.

Thuis gaat het verkeer toch via Cloudflare¶

Symptoom: traag, mislukte grote uploads, OnlyOffice meldt "Connection is lost", terwijl je thuis bent (route 2).

Controle:

python3 -c "import socket; print(sorted({i[4][0] for i in socket.getaddrinfo('fotos.jouwdomein.nl',443)}))"

Thuis moet dit alleen het Umbrel-IP geven.

Je ziet	Oorzaak	Oplossing
alleen Cloudflare-adressen	apparaat gebruikt Pi-hole niet	handmatige DNS, VPN, browser-DNS, Android Privé-DNS: stap 15.2
Umbrel-IP plus een IPv6-adres (`2606:…`, `2a06:…`)	IPv6-lek	`local=/jouwdomein.nl/` in Pi-hole (stap 14.4) en/of IPv6-DNS in de router (stap 15.2c)
Umbrel-IP, maar het werkt toch niet	DNS is goed, het probleem zit erachter	NPM-poort 443 (zie hierboven), certificaat

Op een Mac controleer je ook:

ipconfig getpacket en0 | grep domain_name_server   # wat de router uitdeelt → Umbrel-IP
networksetup -getdnsservers Wi-Fi                  # moet leeg zijn
scutil --dns | head -15                            # met VPN aan staat hier het VPN-adres bovenaan

Onderweg niet bereikbaar (tunnel)¶

Symptoom: via 4G laadt https://fotos.jouwdomein.nl niet (fout van Cloudflare, bijv. 502 of 1033).

Cloudflare Zero Trust → Networks → Tunnels: staat de tunnel op Healthy?
Down/Inactive: controleer of de Cloudflared-app op de Umbrel draait (herstart de app). Is de token nog geldig? Heeft de Umbrel zelf internet?
Tunnel Healthy, maar een 502-fout? Dan klopt de service-URL in de public hostname niet, of draait de app/NPM niet:
route 1: <umbrel-ip>:<app-poort>
route 2: <umbrel-ip>:40080, en de proxy host in NPM moet bestaan.
Is het IP-adres van de Umbrel veranderd? Controleer de DHCP-reservering (stap 4).

Certificaatwaarschuwing thuis¶

Symptoom: thuis "Deze verbinding is niet privé". Onderweg niet.

Controleer in NPM of het certificaat *.jouwdomein.nl geldig is (niet verlopen) en of het bij de proxy host is geselecteerd.
Vernieuwen mislukt? Controleer of de Cloudflare API-token nog bestaat en rechten heeft op jouw zone (stap 13.2).

Bestanden hebben na upload de datum van vandaag¶

Oorzaak: uploaden via de webinterface zet de datum op "nu". Oplossing: kopieer via de netwerkshare of met rsync -a (stap 10).

rsync: "sudo: a terminal is required"¶

Volledige melding: sudo: a terminal is required to read the password; either use the -S option to read from standard input or configure an askpass helper Oplossing: geef rsync tijdelijk sudo zonder wachtwoord, en haal dat daarna weer weg (stap 10.2 route B).

Community app store toont geen update¶

Symptoom: de beheerder van een community store heeft een nieuwe versie uitgebracht, maar Umbrel toont geen update.

Umbrel toont alleen een update als het versienummer in de store hoger is dan wat je hebt geïnstalleerd.
Vernieuwen van de catalogus werkt niet altijd door de store te openen. Workaround: App Store → Community App Stores → verwijder de store en voeg dezelfde URL opnieuw toe. Geïnstalleerde apps en hun data blijven daarbij staan. ⚠️ Te controleren per umbrelOS-versie: maak voor de zekerheid eerst een back-up.

OnlyOffice¶

"The document security token is not correctly formed"¶

Oorzaak: OnlyOffice en FileBrowser Quantum gebruiken verschillende JWT-secrets. Zonder vaste JWT_SECRET maakt OnlyOffice bij elke nieuwe container (na een app- of systeemupdate) een nieuwe willekeurige secret. Oplossing: zet de secret vast in de configuratie van OnlyOffice (JWT_ENABLED, JWT_SECRET) en zet dezelfde waarde in Quantum's config.yaml bij integrations.office.secret. Herstart beide (stap 9 C.3). Wijzig je de secret, doe dat dan op beide plekken.

Controleren of ze gelijk zijn:

sudo docker ps | grep onlyoffice/documentserver
sudo docker exec <container-id> /var/www/onlyoffice/documentserver/npm/json \
  -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
grep -A2 'office:' ~/umbrel/app-data/<quantum-app-id>/data/config.yaml

🛑 De uitvoer bevat je secret. Deel die niet.

Document opent, maar elke paar seconden "Connection is lost"¶

Oorzaak: geen JWT-probleem. De websocket van de editor loopt via Cloudflare in plaats van lokaal. Zie thuis toch via Cloudflare. De meest voorkomende oorzaken zijn handmatige DNS (1.1.1.1) en het IPv6-lek.

Overig¶

Zet in NPM bij de proxy host voor OnlyOffice Websockets Support aan.
⚠️ Te controleren extra NPM-instellingen in het Advanced-tabblad (X-Forwarded-Host, X-Forwarded-Proto, Upgrade/Connection-headers) kunnen de stabiliteit verbeteren. Ze zijn in de praktijkopstelling niet nodig gebleken.
Beperkingen: op mobiel meestal alleen bekijken, en complexe macro's of heel grote bestanden werken niet altijd perfect.

Een website of app werkt niet meer sinds Pi-hole¶

Oorzaak: een blokkeerlijst blokkeert een domein dat die site of app nodig heeft. Oplossing: Pi-hole → Query Log → zoek de geblokkeerde domeinen rond het tijdstip → Allow (toestaan). Even testen? Disable blocking voor 5 minuten.

Immich-app maakt geen back-up¶

iPhone: geef de app toegang tot alle foto's, open de app af en toe, en zet Achtergrondappvernieuwing aan.
Android: zet batterijoptimalisatie voor Immich uit.
Klopt de server-URL? Thuis het Umbrel-IP, en bij automatisch wisselen ook de juiste wifi-naam.
Gebruik je een extra basic-auth op NPM? Controleer de aangepaste proxy-headers in de app.