Como instalar o Cloudron numa VPS Ubuntu
Veja os 3 comandos para instalar o Cloudron numa VPS Ubuntu, configurar DNS wildcard, certificados, correio, backups e dimensionar o servidor para 2 a 10 apps.
Instalar o Cloudron numa VPS: a versão curta
Para instalar o Cloudron numa VPS, precisa de um servidor Ubuntu novo, de pelo menos 2 GB de RAM e de um domínio cujos registos DNS possa editar. A instalação propriamente dita consiste em três comandos e num reboot. Quase todos os problemas ocorrem antes desse passo (imagem base incorreta, tipo de virtualização incorreto) ou depois dele (DNS, correio eletrónico, backups).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupO Cloudron instala, atualiza e faz backups de aplicações self-hosted, além de emitir certificados TLS (transport layer security). Cada aplicação é executada no Docker, o nginx fica à frente de todas elas e cada aplicação recebe o seu próprio subdomínio do domínio. É por isso que o trabalho de DNS vem primeiro neste caso.
Por que o Cloudron exige um sistema operativo base específico
O script de instalação verifica o servidor antes de instalar qualquer componente. Se uma verificação falhar, terá de encomendar um servidor novo. Leia estas verificações antes de escolher uma imagem. As verificações do instalador citadas nesta secção são de October 13, 2026; a documentação de instalação atual pede um servidor Ubuntu 26.04 novo.
- Apenas Ubuntu, e apenas três versões. Qualquer outra versão termina com
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 é rejeitado, e a documentação de instalação pede agora um servidor Ubuntu 26.04 novo. Debian, Rocky e Alpine não são suportados. Ubuntu 24.04 requer Cloudron 8 ou mais recente, e o script verifica isso automaticamente. - Apenas Intel ou AMD de 64 bits:
Error: Cloudron only supports amd64/x86_64. Um VPS ARM não pode executá-lo. - Apenas virtualização completa de hardware. Num VPS baseado em contentores, o script para com
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualizationporque deteta o contentor comsystemd-detect-virt --container. KVM funciona. OpenVZ e LXC não são suportados. - O sistema de ficheiros raiz tem de ser
ext4ouxfs. Com qualquer outro sistema, veráError: Cloudron requires '/' to be ext4 or xfs. É assim que as imagens btrfs e zfs falham. - Pelo menos 941 MB de RAM, medidos com
free -m, e 18 GB em/, medidos pelo tamanho do sistema de ficheiros raiz. A mensagem de erro pede 20GB, mas a verificação aceita um sistema de ficheiros raiz de 19 GB. - Um servidor realmente novo. Se
nginx,dockerounodejá estiver instalado, o script recusa a instalação comError: Some packages like nginx/docker/nodejs are already installed.
Esta última verificação é a que costuma gerar dúvidas. A razão é a seguinte. O Cloudron instala versões fixas do Docker, nginx, Node.js e MySQL, escreve a configuração do nginx para cada aplicação alojada e gere diretamente as regras de firewall do iptables. Um Docker instalado no dia anterior poderia ter a versão errada. Por isso, o script termina sem alterar nada e informa que deve começar com uma instalação nova do Ubuntu. O Cloudron gere toda a máquina, por isso utilize um VPS dedicado.
Há outra verificação fácil de ignorar. Num CPU antigo sem AVX (advanced vector extensions), o script apresenta CPU has no AVX support. MongoDB will be disabled, e todas as aplicações que precisam de MongoDB tornam-se impossíveis de instalar. Verifique o CPU antes de se comprometer com grep -m1 -o avx /proc/cpuinfo. Esse comando apresenta avx num host compatível e não apresenta nada num host antigo.
Quanta RAM o Cloudron necessita?
A verificação do instalador de 13 de outubro de 2026 recusou-se a executar com menos de 941 MB, com Error: Cloudron requires atleast 1GB physical memory; a documentação atual exige 2 GB de RAM e 20 GB de disco. Ambos os valores são o mínimo para a plataforma, não para a plataforma e as suas aplicações. O Cloudron executa Docker, nginx, o seu próprio serviço box e a stack de correio, além de aprovisionar serviços de base de dados partilhados à medida que as aplicações são implementadas. Execute docker ps numa instalação nova e conte-os.
Os limites de memória das aplicações são adicionados a essa base. Cada pacote de aplicação é instalado com um limite baixo predefinido, que pode aumentar no controlo deslizante da vista Resources da aplicação. Quando uma aplicação ultrapassa o seu limite, reinicia e envia uma notificação OOM (out of memory). Por isso, um servidor que reinicia repetidamente uma aplicação tem normalmente um problema de limite, não um bug.
Estas são as dimensões que eu escolheria. São recomendações para um servidor que não terá de reinstalar no próximo mês. Não são resultados de benchmarks medidos.
Os dados por trás deste gráfico
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Duas aplicações funcionam confortavelmente com 4 GB de RAM e 60 GB de disco. Cerca de dez aplicações necessitam de 16 GB e 240 GB, porque a base da plataforma nunca diminui e cada aplicação adiciona uma imagem Docker, uma base de dados e os seus próprios dados. O disco fica cheio mais depressa do que muitas pessoas esperam: as imagens, os dados das aplicações e as cópias de segurança locais partilham o mesmo volume até mover as cópias de segurança para fora do servidor.
O Cloudron fornece swap ilimitada a todas as aplicações, por isso o limite de memória definido aplica-se apenas à RAM. Numa imagem VPS sem ficheiro de swap, swapon --show não apresenta qualquer saída, e a pressão de memória transforma-se diretamente em reinícios OOM, em vez de tornar a aplicação lenta. Adicionar 2 GB de swap é uma medida de segurança barata, mas não substitui a memória real. A diferença entre os planos VPS é pequena comparada com as horas que gastará a ajustar limites. Consulte quanto custa realmente um VPS e escolha o tamanho seguinte.
DNS: o registo wildcard que faz os subdomínios das aplicações funcionarem
O Cloudron coloca o dashboard em my.example.com e cada aplicação no seu próprio subdomínio. Por isso, o DNS é um pré-requisito, não uma etapa posterior. Aponte estes registos para o endereço IP público do servidor antes de abrir o dashboard pela primeira vez:
my.example.comcomo registo A. Este é o dashboard.*.example.comcomo registo A. É este registo que faz os subdomínios das aplicações funcionarem. Assim,wiki.example.comegit.example.comserão resolvidos assim que instalar essas aplicações.example.comcomo registo A, apenas se quiser uma aplicação no domínio base.
Um registo wildcard tem precedência inferior à de um registo explícito. Por isso, um www.example.com existente que aponte para outro local continua a funcionar.
Durante a configuração, escolha como o Cloudron vai gerir o DNS a partir desse momento:
- Um fornecedor com API. O Cloudron armazena um token para Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS e outros (22 integrações de DNS por API no total, excluindo Wildcard, Manual e No-op). Depois, cria todos os registos diretamente, incluindo os registos de correio.
- Wildcard. Adicione manualmente o registo
*. O Cloudron não cria nenhum registo. - Manual. O Cloudron mostra cada registo e aguarda enquanto o adiciona, antes de cada instalação de aplicação.
Um registo DNS wildcard não é um certificado wildcard. O fornecedor de certificados predefinido é Let's Encrypt Prod - Wildcard. Este fornecedor comprova a propriedade através do DNS e, por isso, só funciona com um fornecedor com API. Nos backends Wildcard ou Manual, o Let's Encrypt emite certificados individuais validados por HTTP. Isso exige que a porta 80 aceite ligações de entrada durante a emissão e a renovação. Pode desativar a integração com o Let's Encrypt e carregar um certificado wildcard personalizado. Assim, a porta 80 deixa de ser necessária permanentemente para validar certificados. Se o seu registrador ou alojamento DNS estiver na lista de APIs, use-o: os registos de correio e os certificados deixam de ser sua responsabilidade.
Verifique tudo antes de continuar. dig +short my.example.com e dig +short anything.example.com devem mostrar o endereço IP do seu servidor. No backend Wildcard, se a consulta wildcard não mostrar nada, as aplicações falharão mais tarde, embora o dashboard funcione normalmente.
Se o domínio estiver atrás do Cloudflare, defina os registos como DNS only. O proxy encaminha apenas HTTP e HTTPS, por isso as portas de correio deixam de funcionar. Para aplicações web com proxy, a vista Network do Cloudron permite confiar nos intervalos de IP publicados pelo Cloudflare e recuperar o endereço do visitante a partir dos cabeçalhos encaminhados.
Execute o script de configuração
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupExecute-o como root ou através de sudo, porque, caso contrário, a primeira mensagem apresentada é This script should be run as root.. A instalação demora vários minutos e não apresenta saída durante a execução, porque a saída do apt e os downloads do Docker são enviados para um ficheiro de log. Monitorize esse ficheiro a partir de uma segunda sessão SSH:
tail -f /var/log/cloudron-setup.logNa verificação do instalador realizada em 13 de outubro de 2026, foi apresentada a mensagem After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. seguida do endereço do servidor. Em seguida, o instalador perguntou The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Responda yes. Esse instalador também disponibilizou a flag --skip-reboot para adiar o reinício.
Primeiro arranque: domínio, backend DNS e conta de administrador
Abra https://<server-ip> e aceite o aviso do navegador. O certificado é autoassinado porque o Cloudron ainda não conhece o seu domínio e, por isso, não tem um domínio para enviar a uma autoridade de certificação. No Chrome, clique em Advanced e depois em Proceed to <ip> (unsafe). No Firefox, clique em Advanced e depois em Accept the Risk and Continue.
O primeiro ecrã pede o seu domínio. Introduza example.com e o dashboard passa a estar disponível em my.example.com. Também pode usar um subdomínio, como cloudron.example.com, e nesse caso o dashboard fica em my.cloudron.example.com. Selecione o backend DNS, cole o token da API se tiver um e crie a conta de administrador com um endereço de e-mail que consulte regularmente: as reposições de palavra-passe e as notificações da plataforma usam esse endereço.
Quando guardar, o Cloudron solicita os certificados e move o dashboard para https://my.example.com. O URL com o endereço IP deixa de funcionar nesse momento. Guarde o novo URL nos favoritos.
Certificados: o que renova e quando deixa de renovar
A renovação do certificado é automática e segue o ACME Renewal Information (ARI), o calendário publicado pela autoridade certificadora. Na prática, o certificado é renovado cerca de um mês antes de expirar. Uma renovação falhada envia um e-mail para a conta de administração, e um certificado expirado recorre ao certificado autoassinado integrado. É isso que significa o aviso do navegador num site que funcionava no dia anterior.
Duas causas explicam a maioria dos problemas. A validação HTTP precisa da porta de entrada 80. Por isso, fechar a porta 80 porque "tudo já usa HTTPS" interrompe a renovação das aplicações que usam a validação HTTP do Let's Encrypt num backend Wildcard ou Manual DNS. A validação DNS precisa de um token de API que mantenha acesso de escrita. Por isso, rodar esse token ou restringir as respetivas permissões interrompe a renovação silenciosamente, até chegar o e-mail de aviso.
A vista Domains tem um botão Renew All para forçar imediatamente a tentativa e um fornecedor Let's Encrypt Staging para testes. Os certificados Staging não são considerados fidedignos pelos navegadores de propósito. Esse é o objetivo: os testes evitam consumir os limites de taxa de produção. O Staging tem os seus próprios limites, incluindo 200 falhas de autorização por identificador, por conta e por hora.
Você deve usar o servidor de e-mail integrado?
O Cloudron inclui uma stack completa de e-mail, com caixas de correio IMAP, submissão, filtros sieve e assinatura DKIM (domainkeys identified mail). Você a ativa por domínio, na seção Email do painel. Fazer as mensagens chegarem ao destino é a parte difícil, e nenhuma dessas dificuldades é causada pelo Cloudron.
- A porta de saída 25 é bloqueada pela maioria dos provedores de VPS para controlar spam. Alguns desbloqueiam a porta após um chamado ao suporte. Teste a partir do servidor com
nc -zv aspmx.l.google.com 25(instalenetcat-openbsdse o comando não estiver disponível). As portas abertas exibemsucceeded, e uma porta bloqueada fica pendurada até ocorrer um timeout. - O registro PTR (DNS reverso) é configurado pelo provedor de VPS, não pelo seu provedor de DNS, e precisa corresponder ao hostname de e-mail quando você envia diretamente do servidor. Um smart host elimina essa exigência de PTR.
- Os registros SPF, DKIM e DMARC são criados automaticamente em um backend de DNS com API. Nos backends Wildcard ou Manual, você precisa adicioná-los manualmente. A ausência do registro DKIM faz com que todas as mensagens assinadas sejam consideradas não verificáveis.
Para a maioria das pessoas, a configuração mais prática é receber e-mail no Cloudron e enviar por um relay, como SendGrid, Postmark, Mailgun ou Amazon SES, configurado na visualização Email. O relay precisa permitir o envio como qualquer endereço do seu domínio. Caso contrário, as notificações das aplicações com remetentes diferentes serão rejeitadas. Se o e-mail for o principal motivo para comprar o servidor, execute um servidor de e-mail dedicado, como o Mailcow em outra máquina, com seu próprio IP e reputação.
Se você não usar o Cloudron Email, bloqueie as portas 25, 465, 587, 993 e 4190 no firewall do provedor. Faça isso nele, e não no servidor, porque o Cloudron grava as regras do iptables por conta própria e espera gerenciá-las. Isso é o oposto de uma VPS comum, na qual você gerencia as regras do ufw por conta própria.
Configure o destino dos backups antes de precisar dele
Por padrão, os backups são gravados no sistema de ficheiros local em /var/backups, no mesmo disco que todos os restantes dados. A documentação é clara: "Manter os backups no mesmo disco físico que o servidor da plataforma é perigoso." Uma falha no disco elimina as aplicações e os backups ao mesmo tempo.
Abra Backups, depois Backup Sites, e configure outro destino logo no primeiro dia. O armazenamento de objetos compatível com S3 é a opção habitual (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces ou um bucket MinIO num segundo servidor). Também são suportados destinos SSHFS, NFS, CIFS e do sistema de ficheiros local.
Três definições determinam se vale a pena ter esse backup:
- Formato.
tgzcria um arquivo comprimido por aplicação e volta a carregar o ficheiro completo em cada execução.rsynccarrega apenas os ficheiros alterados. Isto é muito mais barato para uma instalação grande do Nextcloud, mas gera muito mais pedidos à API de armazenamento. - Encriptação. AES-256 opcional que protege os conteúdos dos ficheiros e os nomes dos ficheiros. O Cloudron não guarda uma cópia da palavra-passe. Se a perder, ninguém poderá desencriptar os backups, incluindo você. Guarde-a num gestor de palavras-passe autoalojado antes de clicar em guardar.
- Retenção. É definida com quantidades, como 7 backups diários e 4 semanais. Uma retenção longa no armazenamento de objetos aumenta a fatura todos os meses. Escolha uma quantidade que esteja disposto a continuar a pagar.
Depois, teste um restauro. Instale uma aplicação pequena, restaure-a a partir do painel e confirme que regressa com os respetivos dados. Um backup que nunca foi restaurado é apenas uma suposição.
Limites do plano gratuito
Em outubro de 2026, o plano gratuito está limitado a duas aplicações instaladas. O plano inclui tudo o resto: atualizações das aplicações, backups por aplicação, a firewall, o servidor de email e o single sign-on. A terceira aplicação é o ponto a partir do qual é necessária uma licença. Os planos pagos removem o limite de aplicações, e o plano superior acrescenta grupos e funções de utilizadores, um servidor de diretório e vários sites de backup. Os preços mudam, por isso consulte a página de preços do Cloudron em vez de usar um valor indicado num tutorial.
Uma licença cobre uma instalação do Cloudron, por isso dois servidores pequenos custam o dobro de um servidor maior. Esta estrutura de preços leva a maioria das pessoas a usar um único VPS maior, o que contraria a recomendação habitual de distribuir os serviços por várias máquinas. Dimensione o servidor tendo isso em conta, porque dividir os serviços mais tarde significa pagar duas vezes.
Quando algo falha
Comece pela verificação integrada. Ela verifica o DNS, os certificados, o disco, a memória e cada serviço, pela ordem, e indica qual teste falhou:
sudo cloudron-support --troubleshootDepois, use as ferramentas normais do systemd (gestor do sistema e dos serviços). systemctl status box mostra o estado do próprio serviço Cloudron, journalctl -u box -n 100 apresenta os logs recentes e journalctl -u docker verifica o runtime de contentores subjacente. Tudo o que falhou durante a instalação fica registado em /var/log/cloudron-setup.log.
Se o dashboard não carregar, normalmente o problema está no DNS ou na firewall do fornecedor, não no Cloudron. Execute dig +short my.example.com no seu portátil e confirme que as portas 80 e 443 estão abertas na firewall de rede do fornecedor. Este é um controlo separado das regras do próprio servidor. Na verificação do instalador de 13 de outubro de 2026, uma segunda execução foi recusada com Error: Cloudron is already installed. To reinstall, start afresh. A solução correta é reconstruir o servidor.
Quando o Cloudron não é a opção adequada
O Cloudron é adequado quando pretende gerir aplicações, e não a infraestrutura. É pouco adequado quando pretende executar os seus próprios contentores da forma que escolher, porque controla o nginx, o Docker e a firewall, e substitui as configurações que colocar nesses componentes. Se o seu plano for manter uma pasta com ficheiros Compose, Traefik à frente das suas próprias stacks Docker Compose oferece o mesmo TLS automático e encaminhamento por subdomínio, sem uma plataforma sobreposta. Se ainda não escolheu uma solução, Cloudron, CasaOS e Coolify comparados apresenta-as lado a lado, e a lista mais ampla do que pode alojar autonomamente é um ponto de partida melhor do que um guia de instalação.
FAQ
Quanta RAM o Cloudron precisa numa VPS?
A verificação do instalador de 13 de outubro de 2026 recusou-se a executar com menos de 941 MB; a documentação atual pede 2 GB, mas esse é o limite mínimo para a plataforma sem aplicações instaladas. O Cloudron executa o Docker, o nginx, o seu próprio serviço box e a stack de email, além de aprovisionar serviços de bases de dados partilhados à medida que as aplicações são implementadas. Reserve 4 GB para duas aplicações e 16 GB para cerca de dez, e adicione um ficheiro de swap, porque o Cloudron dá às aplicações swap ilimitado e um servidor sem swap transforma a pressão de memória em reinícios.
Posso instalar o Cloudron no Debian ou num servidor que já execute o Docker?
Nenhuma das opções funciona. Na verificação do instalador de 13 de outubro de 2026, o script parou em versões não suportadas com Cloudron requires Ubuntu 22.04, 24.04, 26.04 e recusou servidores onde nginx, docker ou node já estavam presentes. A documentação de instalação atual exige uma imagem Ubuntu nova e exclui Debian, Rocky e Alpine. Comece com uma imagem Ubuntu nova numa VPS KVM.
Porque falham os subdomínios das minhas aplicações enquanto o dashboard funciona?
No backend Wildcard, verifique o registo DNS wildcard. A configuração cria ou exige um registo A para my.example.com, pelo que o dashboard é resolvido, enquanto wiki.example.com devolve NXDOMAIN e o navegador informa que o site não pode ser encontrado. Adicione um registo A para *.example.com a apontar para o IP do servidor e confirme com dig +short wiki.example.com antes de instalar a aplicação.
Tenho de usar o servidor de email do Cloudron?
Não. Pode desativar o email recebido e enviar através de um relay externo, como Postmark, Mailgun ou Amazon SES. Esta é a opção mais segura quando o seu fornecedor bloqueia a porta de saída 25 ou o endereço IP não tem reputação para envio de email. Se ignorar completamente o Cloudron Email, feche as portas 25, 465, 587, 993 e 4190 na firewall do fornecedor, e não no servidor.
O que acontece quando atinjo o limite de duas aplicações do plano gratuito?
Precisa de uma subscrição paga para instalar uma terceira aplicação. As aplicações que já executa não são afetadas: continuam a ser atualizadas, continuam a ter cópias de segurança e mantêm os seus certificados. Adicionar uma subscrição remove o limite sem reinstalar nada, pelo que o plano gratuito é uma forma adequada de testar primeiro a plataforma num domínio real.