Como redefinir a senha de administrador do Nextcloud com o OCC

Se você não conseguir mais acessar o Nextcloud com uma conta de administrador, o occcomando do lado do servidor pode redefinir a senha dessa conta sem usar a interface web. occé a interface de linha de comando do Nextcloud para administração. A redefinição altera a senha da conta do Nextcloud; ela não altera seu login do Linux, a senha do banco de dados ou a senha do painel de controle da hospedagem.

Este guia utiliza o Manual de Administração do Nextcloud 35, disponível em 6 de outubro de 2026. O comando básico é estável em diversas versões, mas os caminhos de instalação, comandos PHP, contas de serviço e fluxos de trabalho de contêineres variam. Utilize os valores de exemplo somente após verificar como sua própria instância está instalada.

O que você precisa antes de executar a reinicialização

• Acesso ao shell do servidor ou do contêiner que executa o aplicativo PHP do Nextcloud.
• O caminho do sistema de arquivos para a instalação do Nextcloud, que é o diretório que contém o occarquivo.
• O ID exato da conta Nextcloud cuja senha precisa ser alterada. O ID da conta não pode ser admin...
• A conta do sistema operacional usada pelo servidor web ou pelo ambiente de execução do PHP. No Debian e no Ubuntu, geralmente é `user` www-data; outros sistemas podem usar outra conta.
• Uma nova senha exclusiva armazenada em um gerenciador de senhas.

Execute o comando occcomo o usuário HTTP — a conta do sistema operacional que executa o aplicativo web — para que a propriedade e as permissões dos arquivos permaneçam consistentes. O manual do Nextcloud documenta esse requisito. Não execute comandos como root por padrão apenas porque você tem acesso sudo.

Passo 1: Encontre a instalação e a conta corretas.

Conecte-se via SSH ou abra o shell fornecido pelo seu ambiente de hospedagem. Navegue até o diretório de instalação do Nextcloud. Um caminho comum para instalação a partir do código-fonte é `/usr/local/nextcloud` /var/www/nextcloud, mas pacotes, appliances, containers e serviços hospedados podem usar caminhos diferentes.

cd /var/www/nextcloud
ls -l occ

O segundo comando deve exibir um occarquivo. Caso contrário, pare e localize o diretório real do aplicativo em vez de tentar caminhos aleatórios. Se você tiver um nome de conta diferente, substitua-o adminno comando posterior pelo ID de usuário exato do Nextcloud. O ID de usuário não é necessariamente o nome de exibição ou o endereço de e-mail.

Passo 2: Execute a redefinição de senha interativa.

Para uma instalação típica do Debian ou Ubuntu com servidor web em execução como www-data, execute o seguinte comando a partir do diretório do Nextcloud:

sudo -E -u www-data php occ user:resetpassword admin

Substitua `<username> www-data` se o seu servidor usar um usuário HTTP diferente e substitua ` admin<accountID>` pelo ID da conta que você confirmou. Se você ainda não estiver no diretório de instalação, use o caminho completo:

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

O Nextcloud solicitará a nova senha e pedirá que você a confirme. Normalmente, os caracteres da senha não aparecem enquanto você digita; esse é o comportamento esperado. Digite a mesma senha nas duas solicitações. Uma mensagem de sucesso confirmará que o Nextcloud aceitou a redefinição.

Etapa 3: Use uma variável de ambiente apenas para automação

O Nextcloud também oferece suporte --password-from-enva operações automatizadas. Ele lê a senha da OC_PASSvariável de ambiente. Evite inserir a senha real diretamente na linha de comando, no histórico do shell, em scripts armazenados em sistemas de controle de versão ou em registros de terminal compartilhados.

Para uma sessão única no shell, você pode inserir o segredo sem exibi-lo, exportá-lo, executar o comando documentado e, em seguida, apagá-lo:

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

Depois read -s, digite a nova senha e pressione Enter; a entrada permanecerá oculta. A -Eopção solicita que o sudo preserve o ambiente, mas a política local do sudo pode restringir esse comportamento. Se o comando informar que o ambiente OC_PASSestá ausente ou vazio, use a redefinição interativa ou siga o procedimento de gerenciamento de segredos da sua plataforma. Não desative as proteções do sudo apenas para que um script funcione.

Passo 4: Verifique se a conta pode iniciar sessão.

Abra seu URL normal do Nextcloud em uma janela anônima do navegador ou saia da sessão atual e, em seguida, faça login com o mesmo ID da conta e a nova senha. Um login bem-sucedido confirma que a credencial funciona por meio do aplicativo web, e não apenas que o comando da CLI foi executado. Se sua organização usa um segundo fator de autenticação, complete também esse desafio normalmente.

Problemas comuns e como resolvê-los

• Could not open input file: occou um erro de arquivo ausente: Você provavelmente está no diretório errado ou usando o caminho errado. Localize o occarquivo instalado e execute o comando novamente a partir desse diretório.
• Erros de permissão ou propriedade: Verifique a conta do servidor web/PHP da sua distribuição e execute o comando como essa conta. Não altere a propriedade recursivamente como uma solução rápida; isso pode criar problemas de acesso mais amplos.
• Erro de conta "Usuário não existe" ou similar: Confirme o ID da conta, incluindo maiúsculas e minúsculas quando necessário. Não substitua o ID da conta por um endereço de e-mail, a menos que esse seja realmente o ID da conta.
• phpSe estiver faltando ou a versão do PHP selecionada estiver incorreta: Use o binário PHP CLI compatível com sua instalação do Nextcloud e plataforma de hospedagem. Um servidor pode ter mais de uma instalação do PHP, portanto, não assuma que o comando padrão corresponda ao ambiente de execução web.
• O servidor é executado em Docker, Nextcloud AIO, Snap ou em um appliance: execute occno ambiente da aplicação e siga o procedimento de comando oficial dessa implantação. O caminho do host, o nome do contêiner e o usuário de tempo de execução podem ser diferentes; um comando de nível de host copiado de uma instalação de origem pode ter como alvo o sistema de arquivos errado.
• A conta é gerenciada por LDAP ou Active Directory: esses sistemas podem ser a autoridade para as credenciais da conta. Uma redefinição de senha local do Nextcloud pode não atualizar uma senha gerenciada externamente. Siga o procedimento de redefinição do administrador do diretório e verifique a configuração do seu provedor de identidade.
• Você não tem acesso ao shell: tente o link de redefinição de senha na página de login, caso a conta tenha um endereço de e-mail válido salvo no Nextcloud, ou peça a outro administrador do Nextcloud ou ao seu provedor de hospedagem para redefinir a senha.

O que evitar após a recuperação

Não edite o banco de dados do Nextcloud diretamente para substituir o hash de uma senha. Não altere a senha do sistema operacional esperando que isso redefina o usuário do Nextcloud. Mantenha a nova senha em sigilo, remova qualquer segredo temporário do ambiente de shell e armazene-a em seu gerenciador de senhas. Se suspeitar que a credencial antiga foi exposta, revise o acesso por meio do processo de segurança padrão da sua organização.

Referências oficiais

O Nextcloud documenta as opções de recuperação e o procedimento para recuperação de senha de administrador perdida em Redefinindo uma senha de administrador perdida . O comando compatível, as solicitações de senha e a opção de variável de ambiente são descritos em Comandos de usuário e grupo e Usando o comando occ .