Como Atualizar o Nextcloud no Docker sem Quebrar Nada — Guia para Iniciantes - Coisas de Educação

Este post contém link de afiliado.

Como Atualizar o Nextcloud no Docker sem Quebrar Nada – Guia para Iniciantes

Você instalou o Nextcloud, está usando no dia a dia e de repente aparece aquela mensagem chata: “o servidor chegou ao fim da vida útil”. Calma! Neste guia vou te mostrar como atualizar com segurança, passo a passo, mesmo sendo leigo.

Antes de começar: a regra mais importante

Imagine que você está subindo uma escada. Você não pula 3 degraus de uma vez. Você sobe um por um. Com o Nextcloud é igual:

✅ Certo: 30 → 31 → 32 → 33
❌ Errado: 30 → 33 direto (quebra tudo)

Guarde isso: sempre uma versão por vez.

O que é o Docker e por que isso importa?

Se você instalou o Nextcloud seguindo um tutorial com Docker, seus arquivos estão organizados assim:

/mnt/nas-data/nextcloud/
    ├── html/    → código do Nextcloud
    ├── data/    → seus arquivos
    ├── db/      → banco de dados
    └── redis/   → cache

Ver Oferta de HD com desconto no Mercado Livre!!

A vantagem do Docker é que atualizar é simples: você apenas troca a “caixinha” do Nextcloud por uma mais nova, sem mexer nos seus arquivos.

O ciclo de atualização é sempre o mesmo

Para cada versão, o ciclo é este, sem pular nenhuma etapa:

BACKUP → ATUALIZAR → AGUARDAR → DESLIGAR MANUTENÇÃO → CORRIGIR → PRÓXIMA VERSÃO

Parece muito, mas na prática são comandos simples que você vai copiar e colar.

Passo a passo completo

Fase 1: Preparação (proteger seus dados)

Abra o terminal do seu servidor e entre na pasta do Nextcloud:

cd /mnt/nas-data/nextcloud

Veja qual versão está instalada:

docker exec -u www-data nextcloud-app php occ status

Procure a linha versionstring >> vai aparecer algo como 30.0.17. Anote!

Ative o modo manutenção — isso avisa ao Nextcloud para pausar tudo enquanto atualizamos:

docker exec -u www-data nextcloud-app php occ maintenance:mode --on

Deve aparecer: Maintenance mode enabled ✅

Faça o backup do banco de dados — este é o passo mais importante. Se algo der errado, você pode voltar atrás:

docker exec nextcloud-db pg_dump -U nextcloud nextcloud > backup-v$(date +%Y%m%d).sql

Confirme que o backup foi criado:

ls -lh backup-*.sql

Deve aparecer um arquivo com data de hoje e tamanho maior que zero. Se aparecer, pode continuar tranquilo!

Fase 2: Atualização

Troque a versão no arquivo de configuração. Por exemplo, para ir do 31 para o 32:

sed -i 's/nextcloud:31-apache/nextcloud:32-apache/' docker-compose.yml

Confirme que a mudança foi feita:

grep "image:" docker-compose.yml

Deve aparecer nextcloud:32-apache. Se aparecer, ótimo!

Baixe a nova versão do Nextcloud (pode demorar 1-2 minutos):

docker compose pull app

Aplique a atualização:

docker compose up -d --no-deps app

Deve aparecer: Container nextcloud-app Started ✅

Fase 3: Aguardar

O Nextcloud precisa de alguns minutos para se atualizar por dentro. Acompanhe assim:

docker compose logs --tail=10 app
```

Você vai ver várias linhas passando — é o Nextcloud atualizando seus apps internos. **Aguarde** até que só apareçam linhas parecidas com:
```
GET /status.php HTTP/1.1" 200

Quando isso acontecer, terminou! Pode fechar o terminal se quiser — o processo continua rodando em segundo plano.

Fase 4: Finalização

Desligue o modo manutenção para liberar o acesso ao Nextcloud:

docker exec -u www-data nextcloud-app php occ maintenance:mode --off

Deve aparecer: Maintenance mode disabled ✅

Fase 5: Correções pós-atualização (não pule!)

Esta é a etapa que a maioria das pessoas esquece — e que causa problemas depois. Execute sempre após cada versão!

Corrija os índices do banco (deixa o sistema mais rápido):

docker exec -u www-data nextcloud-app php occ db:add-missing-indices

Corrija outras configurações internas:

docker exec -u www-data nextcloud-app php occ maintenance:repair --include-expensive

Ambos podem demorar alguns minutos: aguarde terminar antes de continuar.

Confirme a versão instalada:

O número em versionstring deve ser a versão nova. Se for, parabéns — você concluiu uma atualização!

Checklist Aqui: Imprima ou salve este checklist. Marque cada item antes de partir para a próxima versão

Dúvidas frequentes:

Posso usar o Nextcloud durante a atualização?

Não — o modo manutenção bloqueia o acesso justamente para evitar problemas. Avise os usuários antes de começar.

Quanto tempo demora?

Cada versão leva entre 5 e 15 minutos, dependendo da velocidade da internet e do seu hardware.

O que acontece se eu pular uma versão?

O Nextcloud pode quebrar e se recusar a iniciar. Se isso acontecer, você vai precisar do backup que fez para restaurar.

Meus arquivos ficam seguros durante a atualização?

Sim — a atualização só mexe no código do Nextcloud, nunca nos seus arquivos. O backup que fazemos é do banco de dados, que guarda as configurações e metadados.

E se der erro no meio do processo?

Não entre em pânico! Você tem o backup.
Restaure com:
docker exec -i nextcloud-db psql -U nextcloud nextcloud < backup-vDATA.sql

Conclusão

Atualizar o Nextcloud parece complicado na primeira vez, mas depois que você faz uma vez, vira rotina. O segredo é sempre seguir o ciclo completo — especialmente as correções pós-atualização que muita gente pula.

Boa sorte! E lembre: uma versão por vez, sempre.

Gostou do guia? Deixa nos comentários!

Checklist: use para cada versão. BAIXE AQUI
Imprima ou salve este checklist. Marque cada item antes de partir para a próxima versão

Ver Oferta de HD com desconto no Mercado Livre!!