Instale o ownCloud Infinite Scale com o Docker Compose.

Para uma instalação em servidor, comece com ocis_fullo exemplo oficial do Docker Compose do ownCloud para a versão estável 8.2 da documentação. Ele inclui o serviço Infinite Scale, um proxy reverso e serviços opcionais de colaboração; configure seus domínios, remetente SMTP e caminhos de dados no .envarquivo antes de executar o comando docker compose up -d. Esta configuração foi projetada para uma única instância e requer DNS público e portas acessíveis para certificados Let's Encrypt confiáveis. Para uma avaliação interna sem um domínio, siga a limitação de certificado autoassinado descrita abaixo.

Antes de instalar

Este procedimento segue o guia de produção do OwnCloud Infinite Scale 8.2 com Docker Compose , verificado em 9 de outubro de 2026. O guia é direcionado ao Ubuntu LTS 24.04 ou 22.04 com Docker Engine e Docker Compose já instalados. Recomenda-se pelo menos 4 a 6 GB de memória. Os serviços habilitados por padrão precisam de cerca de 2,4 GB de espaço em disco, sem considerar arquivos de usuário, logs, backups e crescimento futuro.

Escolha este exemplo completo quando puder gerenciar DNS, regras de firewall e um host Linux. Ele inclui mais do que a plataforma de arquivos principal; para avaliação sem domínio, a ownCloud afirma que a configuração usa certificados autoassinados.

• Sistema operacional host: Ubuntu 24.04 LTS ou 22.04 LTS com acesso SSH e sudo.
• Rede: um domínio cujos registros DNS necessários resolvem para o endereço WAN do servidor; permitir as portas TCP de entrada 22, 80 e 443 no firewall e em qualquer roteador upstream.
• Software: Docker Engine e o plugin Compose. No Linux, o Docker documenta a instalação através do seu repositório de pacotes; após a instalação, confirme se o Compose responde com docker compose version.
• E-mail: é necessário inserir um valor SMTP_SENDERpara este exemplo. Complete as outras configurações SMTP se desejar receber e-mails de notificação.

1. Instale o Docker Compose e prepare o host.

Se o Docker Engine já estiver presente, instale o plugin Compose usando o método para sua distribuição Linux nas instruções oficiais de instalação do Compose do Docker . Para sistemas Ubuntu ou Debian onde o repositório do Docker está configurado, o comando de pacote documentado é:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

O Docker recomenda o plugin e o docker composeformulário de linha de comando para instalações atuais. Instale o Docker Engine seguindo as instruções oficiais para Ubuntu, se necessário.

Antes de baixar a configuração, aponte o domínio ou subdomínios que você planeja usar para o IP público do host. O exemplo do ownCloud requer o endereço IP público OCIS_DOMAIN; ele também pode usar o endereço IP público COLLABORA_DOMAINe o endereço IP público ONLYOFFICE_DOMAINquando esses serviços estiverem configurados. Os nomes DNS devem corresponder aos valores em ` .env/etc/network/domains`. Verifique se o seu roteador encaminha as portas 80 e 443 para este host e se um firewall local as permite.

2. Obtenha o exemplo oficial do Compose.

Utilize o ocis_fulldiretório do stable-8.2branch dos exemplos oficiais de implantação do ownCloud . Baixe o arquivo ZIP em um computador com um navegador, transfira-o para o servidor headless com o comando `sudo apt-get install ownCloud` scpe extraia-o /opt/compose/ocis/ocis_fullconforme descrito no guia do ownCloud.

Salve o arquivo atual .envantes de extrair uma cópia atualizada: o ownCloud avisa que o arquivo pode ser sobrescrito. Execute os comandos Compose a partir do diretório do projeto.

3. Configure domínios, certificados, e-mail e caminhos de dados.

Abra /opt/compose/ocis/ocis_full/.envem um editor de texto. Preserve os nomes e a sintaxe das variáveis ​​do exemplo e edite apenas os valores que se aplicam à sua instalação:

• Defina OCIS_DOMAINo nome do host que os usuários irão inserir. Defina os nomes de host do Collabora ou do OnlyOffice somente se esses serviços estiverem habilitados no exemplo.
• Para um servidor exposto à internet, comente as linhas INSECUREconforme indicado no exemplo. Não deixe a configuração insegura ativada para uso público.
• Defina TRAEFIK_ACME_MAILum endereço de e-mail que você controle. Para testes iniciais de certificado, defina TRAEFIK_ACME_CASERVERo servidor de teste do Let's Encrypt. Os certificados de teste não são confiáveis ​​para uso normal; eles ajudam a testar o DNS e a acessibilidade antes de solicitar certificados de produção.
• Configure SMTP_SENDERo servidor SMTP, mesmo que ainda não tenha configurado um servidor de retransmissão de e-mail funcional. O guia oficial informa que a implantação não será iniciada sem ele. Adicione o host SMTP, a porta, as credenciais, a autenticação e as configurações de segurança, quando disponíveis; sem as outras configurações de e-mail, a instância pode ser iniciada, mas não poderá enviar notificações.
• Analise OCIS_DOCKER_IMAGEas tags de imagem no exemplo. Não alterne entre canais de distribuição enquanto estiver seguindo uma instalação de versão estável.
• Para um servidor de produção, considere atribuir OCIS_DATA_DIRcaminhos OCIS_CONFIG_DIRde host planejados em armazenamento com capacidade suficiente e cobertura de backup. Os padrões usam volumes gerenciados pelo Docker, que são convenientes, mas o ownCloud observa que a localização, os snapshots, o backup, a restauração, a reinicialização e a migração desses volumes dependem do armazenamento do host Docker.

Restrinja o acesso ao servidor e ao seu arquivo de configuração. Um certificado autoassinado é adequado apenas para avaliação interna, não para uma implementação pública confiável.

A partir do diretório do projeto, valide a configuração mesclada antes de iniciar os contêineres:

cd /opt/compose/ocis/ocis_full
docker compose config

Corrija os erros de variáveis ​​ou YAML relatados antes de continuar. Este comando exibe a configuração do Compose para inspeção; ele não comprova que o DNS, os certificados, as permissões de armazenamento ou a conectividade SMTP estejam funcionando.

4. Inicie os serviços e conclua a configuração do certificado.

Inicie a pilha em segundo plano:

docker compose up -d

A primeira execução baixa as imagens e inicia os serviços, por isso pode demorar mais do que reinicializações posteriores. Verifique o estado do serviço com:

docker compose ps -a

Em seguida, verifique os registros se um serviço for encerrado ou se o endereço da web não carregar:

docker compose logs --follow

Comece pelos logs do Traefik. Erros de certificado geralmente apontam para incompatibilidade de DNS e .envvalores, portas 80/443 bloqueadas ou um e-mail ACME inválido. Corrija a causa antes de tentar novamente. Não use docker compose down -vcomo uma redefinição: isso remove todos os volumes do projeto, incluindo os dados.

Quando as verificações de certificado de teste forem bem-sucedidas, siga o procedimento de certificado do ownCloud: interrompa a implantação, remova apenas o volume de certificado de exemplo ( ocis_full_certs), limpe a configuração da CA de teste e inicie novamente para solicitar certificados de produção confiáveis. Confirme o nome exato do volume com docker volume lsantes de removê-lo. Não remova os volumes de dados ou de configuração.

Verificar o acesso e proteger a implementação

Abra o URL definido em OCIS_DOMAIN. Um resultado bem-sucedido significa que o navegador acessa a página de login via HTTPS sem aviso de certificado e docker compose ps -aexibe os serviços necessários em execução. Faça login usando as credenciais iniciais documentadas pelo ownCloud ( admin/ admin, a menos que você tenha definido uma senha inicial diferente) e, em seguida, altere a senha de administrador imediatamente.

Se o site estiver indisponível, verifique o DNS, o encaminhamento de portas, os logs ACME do Traefik e, em seguida, os logs do serviço Infinite Scale. Se o login funcionar, mas as notificações por e-mail não, verifique as configurações de SMTP.

Antes de armazenar arquivos importantes, confirme se seu backup abrange tanto a configuração quanto os dados. Volumes gerenciados pelo Docker são convenientes para avaliação; caminhos explícitos do host são mais fáceis de colocar em um disco separado e incluir nos backups do host. Você estará pronto quando o HTTPS estiver funcionando, os serviços permanecerem em execução após a reinicialização, o login de administrador estiver funcionando e os backups cobrirem o armazenamento escolhido.