Remova o Nextcloud travado no modo de manutenção com segurança usando o OCC.

Se o Nextcloud ainda exibir "modo de manutenção" após uma atualização ou tarefa de manutenção, verifique primeiro se a atualização do banco de dados foi concluída. Quando occ statusa mensagem for exibida needsDbUpgrade: false, execute o comando occ maintenance:mode --offcomo o usuário do servidor web na instalação correta do Nextcloud; se a mensagem for exibida true, conclua o comando occ upgradeantes de reabrir o site.

Desativar o sinalizador restaura os logins, mas não corrige uma atualização com falha. O objetivo é trazer a instância de volta online com o sinalizador de manutenção e o estado da atualização verificados.

1. Verifique a instância antes de alterar seu estado.

Conecte-se ao host ou contêiner que hospeda a URL do Nextcloud afetada. Para uma instalação manual no Linux, acesse o diretório do Nextcloud (geralmente `/var/www/nextcloud` /var/www/nextcloud) e verifique o status como o usuário HTTP:

cd /var/www/nextcloud
sudo -E -u www-data php occ status

Procure por `maintenance` maintenancee ` true` needsDbUpgrade. Um estado típico em que é seguro desativar o modo de manutenção é maintenance: truecom `true` needsDbUpgrade: false. Se `maintenance` já estiver definido como `false`, o navegador pode estar exibindo uma página desatualizada ou acessando um servidor diferente. Se `maintenance` needsDbUpgradeestiver definido como `true`, não desative o modo de manutenção ainda.

O Nextcloud exige que o OCC seja executado como o usuário HTTP para que a propriedade dos arquivos permaneça consistente. No Debian ou Ubuntu, geralmente é o usuário `sudo` www-data; outras distribuições podem usar `sudo` apache, http`sudo` ou ` wwwrunsudo`. Verifique a conta de serviço da sua instalação antes de substituir o usuário em um comando. A documentação atual do Nextcloud OCC lista as diferenças de usuário e o comando de status.

2. Desative o modo de manutenção com OCC

Para instalar um arquivo ou pacote, execute o comando a partir do diretório que contém o occscript correto:

sudo -E -u www-data php occ maintenance:mode --off

O comando deve informar que o modo de manutenção está desativado. Essa --offopção altera o estado de manutenção; ela não executa migrações, não corrige permissões nem desfaz uma substituição de arquivo interrompida.

Use o wrapper que corresponde à sua instalação. Para a imagem Docker oficial do Nextcloud, a documentação do projeto inclui docker execexemplos de Docker Compose. Substitua o nome do contêiner ou serviço de exemplo pelo seu:

# Docker Compose; "app" is an example service name
docker compose exec --user www-data app php occ maintenance:mode --off

# Docker; replace CONTAINER_ID with the Nextcloud container
docker exec -it --user www-data CONTAINER_ID php occ maintenance:mode --off

Para o Snap do Nextcloud, use o wrapper OCC do lado do host em vez de acessar os diretórios internos do snap:

sudo nextcloud.occ maintenance:mode --off

O projeto Snap observa que isso /snap/bin/nextcloud.occpode ser necessário se o diretório não estiver no PATH do shell. Consulte as instruções de modo de manutenção do Snap . O README da imagem Docker oficial do Nextcloud documenta o padrão de comando do contêiner.

3. Se ainda houver uma atualização pendente, conclua-a primeiro.

Quando needsDbUpgrade: trueo Nextcloud envia relatórios de status, ele indica que a migração de código e de banco de dados não está sincronizada. Isso geralmente ocorre depois que um atualizador substituiu o código, mas a fase de migração não foi concluída. Nesse estado, um conjunto limitado de comandos OCC pode estar disponível e o modo de manutenção pode ser intencionalmente mantido ativado para impedir o acesso dos usuários durante a atualização.

Utilize o caminho de atualização correspondente ao seu tipo de instalação e verifique o erro do atualizador antes de prosseguir. Para uma instalação padrão baseada em arquivo, após confirmar se a versão desejada do código Nextcloud está presente e fazer um backup completo do banco de dados e dos arquivos/configurações, caso ainda não os tenha, execute:

sudo -E -u www-data php occ upgrade

Deixe o comando ser concluído e resolver qualquer falha relatada. Não alterne repetidamente o modo de manutenção para contornar um erro de migração. A documentação de atualização do Nextcloud explica que a migração do banco de dados ocorre após a substituição do código do servidor e recomenda um backup recente antes da atualização. Docker, Snap e pacotes gerenciados podem ter seus próprios procedimentos de atualização; use essas instruções se elas forem diferentes do exemplo baseado em arquivo.

Após a conclusão bem-sucedida da atualização e o status não indicar mais uma atualização de banco de dados pendente, execute o maintenance:mode --offcomando apropriado acima. Evite editar config.phpou usar uma atualização direta do banco de dados como atalho. Se o OCC não conseguir gravar a configuração, verifique se você selecionou a instalação e o usuário HTTP corretos e inspecione qualquer política de configuração somente leitura ou erro de permissão do sistema de arquivos antes de alterar as permissões.

4. Verifique a bandeira e o site em funcionamento.

Execute o comando `status` novamente usando o mesmo caminho de instalação, contêiner e usuário:

sudo -E -u www-data php occ status

Confirme ambos maintenance: falseos campos needsDbUpgrade: false. No Docker ou Snap, repita a verificação usando o mesmo wrapper utilizado para desativar a flag. O comando de status do Nextcloud documenta esses campos; seu formato legível por máquina é occ status --output=json_pretty.

Em seguida, recarregue o site em uma nova aba do navegador e teste o login normal e a listagem de arquivos. O Nextcloud observa que os usuários que estavam conectados antes do modo de manutenção podem precisar atualizar o navegador após o servidor voltar a ficar online. Se o OCC reportar "manutenção falsa", mas o site ainda exibir a página de manutenção, verifique se o nome do host ou o balanceador de carga está apontando para a mesma instância que você alterou; com vários contêineres ou nós, outro backend pode ainda estar em modo de manutenção.

Uma correção bem-sucedida, portanto, é mais do que uma resposta de comando "desativado": o status do OCC deve mostrar ambas as flags desativadas e a URL pública pretendida deve servir a instância em funcionamento. Se a flag de atualização permanecer ativa ou o comando de migração falhar, impeça o acesso dos usuários e resolva o erro de atualização antes de reabrir o Nextcloud.