Nextcloud / MANUAL TÉCNICO

Instalar Nextcloud: pacote, banco e occ

Procedimento de instalação manual com pacote oficial e comandos occ no Debian/Ubuntu.

Editora: Arquindex · Revisado em 06/11/2026Ler em Markdown ↗

Roteiro manual para ambiente novo; requer preparar servidor web, PHP e banco. Não executado nesta revisão.

Resposta direta

A instalação manual exige PHP, servidor web e banco antes de executar occ maintenance:install. O comando deve rodar com o usuário HTTP. Valide domínio, cron, upload, compartilhamento e backup.

1. Escolher o método de instalação

Escolha entre pacote do servidor, instalador web ou All-in-One. O pacote ZIP exige servidor web, PHP e banco configurados; AIO coordena contêineres e possui requisitos próprios de proxy e acesso ao Docker.

Downloads oficiais · Nextcloud AIO · Requisitos do canal estável

2. Baixar e registrar o pacote

O alias latest.zip é móvel. Para reproduzir a instalação, registre a versão retornada, a origem e o checksum. Em produção, selecione um pacote versionado no catálogo oficial.

Baixar pacote e checksum · Bash

mkdir nextcloud-pacote
cd nextcloud-pacote
curl --fail --location --output latest.zip https://download.nextcloud.com/server/releases/latest.zip
curl --fail --location --output latest.zip.sha256 https://download.nextcloud.com/server/releases/latest.zip.sha256
sha256sum latest.zip
cat latest.zip.sha256

Compare o hash calculado com o valor publicado no arquivo SHA-256; eles devem ser idênticos. Uma verificação de hash não substitui a verificação de autenticidade da assinatura publicada pelo projeto.

3. Preparar aplicação, PHP e banco

Extraia o pacote no diretório definido para a aplicação. Configure um virtual host e um banco dedicado com usuário próprio. Confira extensões PHP e diferenças entre o PHP do servidor web e o CLI. O diretório de dados deve ter uma localização e política de acesso definidas.

4. Executar a instalação via occ

Exemplo para uma aplicação preparada em /var/www/nextcloud, banco MySQL/MariaDB já criado e usuário HTTP www-data. O comando interativo solicitará as senhas.

Instalação interativa · Debian/Ubuntu

sudo -u www-data php /var/www/nextcloud/occ maintenance:install \
  --database mysql --database-name nextcloud \
  --database-user nextcloud --admin-user admin
sudo -u www-data php /var/www/nextcloud/occ status

5. Concluir a configuração operacional

Configure domínio confiável, HTTPS, cron e cache/locking conforme o manual. Faça login, envie e baixe um arquivo, teste compartilhamento com usuário sem privilégios e restaure uma cópia do banco, dados e configuração em ambiente separado.

Diagnóstico

Consultar status e comandos disponíveis

sudo -u www-data php /var/www/nextcloud/occ status --output=json
sudo -u www-data php /var/www/nextcloud/occ list
sudo -u www-data php /var/www/nextcloud/occ maintenance:install --help

Problemas de permissão: conferir o usuário HTTP e os diretórios. Erro de driver: conferir extensão PHP correspondente ao banco. Divergência CLI/web: comparar as configurações dos dois runtimes.

Fontes do procedimento

Instalação por linha de comando · Manual do occ · Pacotes e assinaturas

Baixar exemplo: nextcloud-occ.txt · Trecho didático para adaptar; não é um instalador completo.