Als een serverbeheerder geen toegang heeft tot de webinterface van Nextcloud, kan hij of zij het wachtwoord van een lokaal account wijzigen. Als u wel toegang heeft tot de servershell, kunt u de ingebouwde Nextcloud- occ user:resetpasswordopdracht uitvoeren als de webservergebruiker en vervolgens inloggen met dezelfde accountnaam en het nieuwe wachtwoord. De opdracht werkt zowel voor beheerdersaccounts als voor gewone gebruikers; "admin" is slechts een voorbeeldgebruikersnaam.
De onderstaande commando's volgen de Nextcloud 35-beheerhandleiding, gecontroleerd op 10 oktober 2026. Vervang het voorbeeldinstallatiepad, de HTTP-gebruiker, het PHP-uitvoerbare bestand en de gebruikersnaam door de waarden die op uw server worden gebruikt.
Het wachtwoord interactief opnieuw instellen
1. Zoek de Nextcloud-installatie en het webserveraccount.
Maak verbinding met de host met een account dat een shell kan gebruiken en verhoogde bevoegdheden heeft. Zoek de map waarin het occscript zich bevindt. Een veelvoorkomend pad in Ubuntu of Debian is /var/www/nextcloud; sommige pakket-, container- of gehoste installaties gebruiken een andere locatie. De opdracht moet worden uitgevoerd in de Nextcloud-installatiecontext en als de HTTP-gebruiker, zodat het eigenaarschap van de bestanden consistent blijft.
Op Debian of Ubuntu is die gebruiker meestal www-data. Nextcloud-documentatie apachevoor Fedora of CentOS, httpvoor Arch en wwwrunvoor openSUSE. Gebruik je daadwerkelijke webserveraccount, niet per se het Linux-account waarmee je inlogt.
2. Voer de OCC-wachtwoordherstelopdracht uit.
Gebruik dit commando op een standaard Debian- of Ubuntu-installatie en vervang de gebruikersnaam door de juiste als deze niet leeg is admin:
sudo -u www-data php /var/www/nextcloud/occ user:resetpassword admin
Nextcloud vraagt om een nieuw wachtwoord en verzoekt u dit opnieuw in te voeren. Het wachtwoord wordt niet in de shellopdracht opgenomen, waardoor het niet in de shellgeschiedenis terechtkomt. Wanneer de opdracht meldt dat het wachtwoord succesvol is gereset, probeer dan in te loggen op de website met die gebruikersnaam en het nieuwe wachtwoord. Gebruik geen punthaken rond de gebruikersnaam wanneer u deze vervangt.
De officiële documentatie laat dit ook zien sudo -E -u www-data. De -Eoptie behoudt omgevingsvariabelen; deze is niet nodig voor de gebruikelijke interactieve reset, tenzij uw installatie specifieke omgevingsinstellingen vereist. Voer de opdracht uit occmet de PHP CLI-versie die is geconfigureerd voor uw webserver. Als het standaard phpuitvoerbare bestand incompatibel is, roep dan expliciet het overeenkomende PHP-binaire bestand aan.
Als u niet zeker weet welk account u moet resetten
De inlognaam is de Nextcloud-gebruikersnaam van het account, niet per se de weergavenaam of het e-mailadres. Als u een ander beheerdersaccount hebt, kunt u de betreffende inlognaam controleren op de pagina Gebruikers. Vanaf de opdrachtregel kan een beheerder accounts weergeven met:
sudo -u www-data php /var/www/nextcloud/occ user:list
Vervang www-datade OCC-paden indien nodig. De uitvoer kan veel gebruikersaccounts bevatten, dus deel deze niet openbaar als deze identificerende informatie bevat. Voor zeer grote installaties ondersteunt de opdracht opties zoals limieten en offsets; controleer de huidige occ help user:listuitvoer voor de syntaxis die beschikbaar is in uw versie.
Als je nog steeds toegang hebt tot een andere Nextcloud-beheerder, is het eenvoudiger om diegene te vragen je wachtwoord opnieuw in te stellen via de gebruikersinstellingen. De link voor het opnieuw instellen van je wachtwoord op de inlogpagina is een andere optie, maar alleen als er eerder een geldig e-mailadres op je persoonlijke pagina is opgeslagen en de server e-mail kan verzenden. OCC is handig als geen van beide opties beschikbaar is, maar je wel shelltoegang hebt.
Los veelvoorkomende problemen met de opdrachtregel op.
"Kan invoerbestand niet openen" of "occ niet gevonden"
De opdracht verwijst naar de verkeerde installatiemap. Wijzig het pad naar het daadwerkelijke occscript. U kunt ook naar de installatiemap gaan en de kortere versie uitvoeren sudo -u www-data php occ user:resetpassword admin. Voer geen script met een vergelijkbare naam uit vanuit een andere Nextcloud-installatie op dezelfde server.
Permissie-, cache- of PHP-fouten
Controleer of u het HTTP-account en dezelfde PHP CLI-versie hebt gebruikt als die door de installatie wordt verwacht. De OCC-documentatie van Nextcloud vermeldt dat APCu standaard is uitgeschakeld in de PHP-opdrachtregelmodus; als OCC meldt dat APCu niet beschikbaar is, schakel het dan in apc.enable_clivoor de juiste CLI-configuratie of volg de gedocumenteerde --define apc.enable_cli=1instructies. Wijzig de PHP-webinstellingen niet zomaar om een CLI-specifieke fout op te lossen.
Het account maakt gebruik van een externe identiteitsaanbieder.
Sommige installaties authenticeren accounts via LDAP, SAML of een andere externe identiteitsprovider. In dat geval kan de provider de autoriteit zijn voor het wachtwoord en kan een OCC-reset op basis van de lokale accountgegevens van Nextcloud de bij het aanmelden gebruikte inloggegevens mogelijk niet wijzigen. Reset het wachtwoord via de goedgekeurde procedure van de identiteitsprovider of controleer of de geconfigureerde backend wachtwoordwijzigingen ondersteunt voordat u OCC gebruikt. Deze opdracht is bedoeld voor het Nextcloud-accountwachtwoord en reset niet de eigen inloggegevens van een identiteitsprovider.
Je draait Nextcloud in een container of op managed hosting.
Voer OCC uit in de applicatiecontainer of via de door de provider ondersteunde shell, niet op een ongerelateerde host. Containernamen, installatiepaden, PHP-opdrachten en servicegebruikers verschillen per implementatie, dus kopieer geen Docker-opdracht die voor een andere image is geschreven zonder de bijbehorende documentatie te raadplegen. Managed hosting kan de shelltoegang beperken; gebruik het controlepaneel van de provider of vraag naar de gedocumenteerde herstelprocedure als u OCC niet kunt uitvoeren.
Controleer of u weer toegang hebt gekregen.
Controleer of OCC een succesbericht heeft weergegeven en open vervolgens de gebruikelijke Nextcloud-URL in een privévenster van uw browser om in te loggen met de exacte gebruikersnaam en het nieuwe wachtwoord. Een privévenster helpt om een wachtwoordprobleem te onderscheiden van een oude sessie of een inlogpagina die in de cache is opgeslagen. Controleer na het inloggen of het account nog steeds beheerdersrechten heeft en of u de beheerdersinstellingen kunt openen. Als het inloggen nog steeds mislukt, controleer dan de gebruikersnaam, de authenticatiebackend, het serverlogboek en of OCC op de juiste instantie is uitgevoerd; het herhalen van de reset op de verkeerde instantie zal de actieve server niet herstellen.
Officiële referenties