Olá! Manter o Nextcloud atualizado é essencial para garantir a segurança, estabilidade e desempenho da plataforma. Este guia aborda os três principais métodos de atualização: via interface web, linha de comando e manual.
Leia mais: Atualizando o Nextcloud: Métodos via Web, Linha de Comando e Manual1. Preparação Antes da Atualização
Antes de iniciar qualquer atualização, siga estas etapas essenciais:
Backup Completo
Antes de qualquer atualização, faça um backup completo do sistema para evitar perda de dados. Certifique-se de salvar:
- O banco de dados;
- O diretório de dados (
data); - O arquivo de configuração (
config/config.php).
Verificação de Aplicativos de Terceiros
- Desative aplicativos de terceiros temporariamente;
- Consulte a compatibilidade dos aplicativos com a versão mais recente do Nextcloud.
2. Atualização via Interface Web
O Nextcloud possui um atualizador embutido que facilita a atualização diretamente pelo navegador.
Passos:
- Acesse Configurações > Visão Geral;
- Se houver uma atualização disponível, clique em Abrir Atualizador;
- Siga as instruções na tela para completar o processo.
Observações:
- O Nextcloud entrará em modo de manutenção durante a atualização;
- Após a conclusão, verifique se todos os aplicativos e funcionalidades estão operando corretamente;
- Reative os aplicativos de terceiros conforme necessário.
3. Atualização via Linha de Comando
A atualização via terminal é recomendada para instalações maiores ou ambientes de produção, pois oferece maior controle sobre o processo.
Passos:
- Acesse o diretório de instalação do Nextcloud:
cd /caminho/para/nextcloud - Execute o atualizador:
sudo -u [USUÁRIO_DO_SERVIDOR_WEB] php updater/updater.pharSubstitua[USUÁRIO_DO_SERVIDOR_WEB]pelo usuário que o servidor web está executando (exemplo:www-datapara Apache em Debian/Ubuntu,nginxpara Nginx, etc.). - Siga as instruções apresentadas no terminal.
- Após a atualização, execute:
sudo -u [USUÁRIO_DO_SERVIDOR_WEB] php occ upgrade - Verifique se tudo está funcionando corretamente e reative os aplicativos de terceiros, se necessário.
4. Atualização Manual
Caso as opções anteriores não sejam viáveis, a atualização manual pode ser utilizada.
Passos:
- Faça um backup completo (banco de dados, arquivos e configurações).
- Baixe a versão mais recente do Nextcloud no site oficial.
- Extraia o arquivo baixado em um diretório temporário.
- Pare o servidor web:
sudo systemctl stop apache2 # Para Apache em Debian/Ubuntu sudo systemctl stop httpd # Para Apache em RHEL e derivados sudo systemctl stop nginx # Para Nginx - Renomeie o diretório atual do Nextcloud:
mv /caminho/para/nextcloud /caminho/para/nextcloud_old - Mova o novo diretório extraído para o local do Nextcloud:
mv /caminho/temporario/nextcloud /caminho/para/nextcloud - Copie o arquivo de configuração:
cp /caminho/para/nextcloud_old/config/config.php /caminho/para/nextcloud/config/ - Se necessário, mova o diretório
datapara a nova instalação. - Ajuste as permissões dos arquivos:
sudo chown -R [USUÁRIO_DO_SERVIDOR_WEB]:[GRUPO_DO_SERVIDOR_WEB] /caminho/para/nextcloud find /caminho/para/nextcloud/ -type d -exec chmod 750 {} \; find /caminho/para/nextcloud/ -type f -exec chmod 640 {} \; - Reinicie o servidor web:
sudo systemctl start apache2 # Para Apache em Debian/Ubuntu sudo systemctl start httpd # Para Apache em RHEL e derivados sudo systemctl start nginx # Para Nginx - Execute o comando de atualização:
sudo -u [USUÁRIO_DO_SERVIDOR_WEB] php occ upgrade - Verifique se todos os aplicativos e funcionalidades estão funcionando corretamente.
Possíveis Avisos Após a Atualização
Após concluir a atualização do Nextcloud, alguns avisos podem aparecer na interface de administração. Aqui estão dois exemplos comuns e como resolvê-los:
Aviso sobre migração de tipos MIME:
O Nextcloud pode informar que novas migrações de tipos MIME estão disponíveis para melhorar o suporte a determinados arquivos. Como essa operação pode ser demorada em grandes instâncias, não é realizada automaticamente. Para executar a migração manualmente, use:
sudo -u [USUÁRIO_DO_SERVIDOR_WEB] php occ maintenance:repair --include-expensive
Aviso sobre índices ausentes no banco de dados:
Ocasionalmente, novos índices são adicionados para otimizar o desempenho do banco de dados. Para adicionar os índices ausentes, execute:
sudo -u [USUÁRIO_DO_SERVIDOR_WEB] php occ db:add-missing-indices
Considerações Finais
- Leia as notas de versão antes de atualizar para conhecer possíveis mudanças importantes;
- Não é possível pular versões principais durante a atualização. Atualize de forma sequencial (exemplo: 27 → 28 → 29);
- Após a atualização, certifique-se de que todas as funcionalidades e aplicativos estão operando normalmente;
- Se ocorrerem erros, consulte os logs do Nextcloud (
data/nextcloud.log) para diagnóstico.
Seguindo essas etapas, sua instância do Nextcloud será mantida segura e atualizada com a versão mais recente disponível.

Deixe um comentário