Base de Conhecimento

CloudPanel na VPS: como instalar e hospedar sites

  • cloudpanel, vps, painel de controle, ubuntu, debian, lets encrypt
  • Usuários acharam útil: 0

Instale o CloudPanel numa VPS: licença, requisitos de novembro de 2026, instalação, proteção do primeiro acesso, domínio, HTTPS, backups e atualização.

Por Redação Eleven Host · @robson.direitodigital · 7 de novembro de 2026 · 11 min de leitura

Arte da Eleven Host: janela de terminal com o título: CloudPanel na VPS: como instalar e hospedar sites

Capa da Redação Eleven Host para o tutorial: CloudPanel na VPS: como instalar e hospedar sites Arte: Eleven Host

O CloudPanel na VPS é uma forma de ter um painel de controle gratuito para criar e gerenciar sites no seu próprio servidor. Veja a licença, os requisitos, a instalação, o primeiro acesso, o domínio, o HTTPS, os backups e a atualização.

Atualizado em 07/11/2026, com base na documentação oficial do CloudPanel, que está na versão 2.5.4 em novembro de 2026. Se você ainda não tem um servidor, o guia de servidor VPS explica o que é e como escolher.

Logo depois de instalado, o painel fica esperando alguém criar o usuário administrador, e a documentação avisa que há uma janela de tempo em que robôs podem criar esse usuário antes de você.

O que é o CloudPanel e qual é a licença

A frase oficial da documentação descreve o CloudPanel como um painel de servidor gratuito e moderno, com foco em simplicidade. Segundo a documentação, ele roda sites em PHP, Node.js, HTML estático, aplicações Python e proxies reversos, e funciona em processadores x86 e ARM.

Ele é gratuito, e não encontramos edição paga no site do projeto. Mas é um software proprietário: a licença pertence à empresa que o mantém, a MGT-COMMERCE, de Berlim, na Alemanha, e os termos permitem que a empresa os altere ou revogue no caso da licença gratuita. Isso quer dizer que as condições de hoje podem mudar.

O cenário aqui é instalar na sua própria VPS para os seus próprios sites. Se a ideia for hospedar sites de terceiros, cobrar pelo uso ou revender o painel, leia os termos de licença no site do CloudPanel e peça autorização por escrito à empresa. Esses casos ficam fora daqui, e uso comercial por revenda não deve ser tomado como liberado.

O projeto está ativo: a versão 2.5.4 saiu em 01/07/2026, com suporte a Node.js 24 LTS, MariaDB 12.3 e Ubuntu 26.04, além de correções.

Sistemas e bancos de dados suportados

Pela página de requisitos, o CloudPanel 2.5.4 suporta estes sistemas, em x86 e em ARM64:

  • Ubuntu 26.04, 24.04 e 22.04;
  • Debian 13 e Debian 12.

Confira a lista na página de requisitos no dia da instalação, porque a lista pode mudar em outra versão. O instalador oferece estes bancos pela variável DB_ENGINE: MYSQL_8.4, MYSQL_8.0, MARIADB_12.3, MARIADB_11.8, MARIADB_11.4, MARIADB_10.11 e MARIADB_10.6. A página de instalação traz um bloco de comando por sistema, e a lista de bancos muda de um bloco para outro. Por isso, recomendamos copiar o bloco do sistema que você vai usar.

Requisitos mínimos do CloudPanel

A documentação pede, no mínimo:

  • 1 núcleo de processador;
  • 2 GB de memória RAM;
  • 10 GB de disco.

São os mínimos do próprio CloudPanel, e não a descrição de um plano de VPS.

Servidor vazio e acesso root

A documentação pede um servidor vazio, com um dos sistemas suportados e com acesso root. Recomendamos instalar numa VPS nova ou recém-reinstalada, porque não encontramos desinstalador, como explicamos mais adiante.

Um servidor para o painel

O CloudPanel é instalado num servidor vazio, com um dos sistemas da lista e acesso root.

Em busca de um servidor virtual? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Antes de instalar: proteja a porta 8443

O painel atende na porta 8443. Segundo a documentação, se possível, libere essa porta só para o seu IP, no firewall que você usa para o servidor; recomendamos fazer isso antes de instalar. Isso só funciona para quem tem IP fixo; para quem não tem, a documentação recomenda colocar um Basic Auth na frente do painel. O Basic Auth só pode ser ligado depois da instalação, e nesse momento o painel ainda não tem administrador. Por isso, recomendamos ligá-lo por SSH, logo ao terminar a instalação e antes de abrir o painel no navegador. Um exemplo de comando, como na documentação, para conferir no próprio servidor (troque usuário e senha):

clpctl cloudpanel:enable:basic-auth --userName=john.doe --password='SENHA-AQUI'

Com a porta restrita ao seu IP ou com o Basic Auth ligado, abra o painel e crie o administrador logo em seguida.

A documentação também recomenda liberar a porta 22, do SSH, só para os seus IPs, para elevar a segurança. Faça isso só depois de ter certeza do seu IP, para não ficar sem acesso ao servidor.

Instale o CloudPanel

Entre no servidor por SSH como root. Um exemplo, com a chave privada ou com senha, como na página oficial (troque pelo IP do seu servidor):

ssh -i path_to_your_private_key root@yourIpAddress

ssh root@yourIpAddress

Depois, atualize o sistema e instale as ferramentas que o instalador usa:

apt update && apt -y upgrade && apt -y install curl wget sudo

O instalador confere um checksum antes de rodar. Esse valor muda quando o instalador muda, então copie o comando atual da página oficial de instalação do CloudPanel, no bloco do seu sistema, e não o do exemplo abaixo. Um exemplo de comando, copiado da página oficial; antes de rodar, compare com o bloco atual de lá:

curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh; \

echo "8146dbe0a488e7088b04071b0c34d59aa0ab1fe9dcec382d395fd155c9e6c476 install.sh" | \

sha256sum -c && sudo DB_ENGINE=MYSQL_8.4 bash install.sh

Só a variável DB_ENGINE muda de um bloco para outro. Se o checksum não bater, o sha256sum -c falha e o instalador não roda: nesse caso, copie o comando de novo da página oficial.

Primeiro acesso e criação do administrador

Terminada a instalação, abra no navegador o endereço https://yourIpAddress:8443, trocando pelo IP do servidor. O navegador vai mostrar um aviso, porque o certificado inicial é autoassinado. Na página oficial, a instrução é clicar em Advanced e depois em Proceed.

Entre o mais rápido possível para criar o usuário administrador. É a janela de tempo do aviso lá em cima: enquanto ninguém criou o usuário, um robô que ache a porta aberta pode criá-lo antes de você. Por isso recomendamos restringir a porta 8443 antes de instalar.

Checklist do primeiro acesso

  • servidor vazio, com um sistema da lista e acesso root;
  • porta 8443 liberada só para o seu IP, ou Basic Auth ligado por SSH antes de abrir o painel;
  • comando de instalação copiado da página oficial, no bloco do seu sistema;
  • administrador criado logo após a instalação;
  • domínio apontado para o servidor antes de pedir o certificado.

Crie um site

Pela interface, ao adicionar um site você escolhe entre WordPress, HTML/CSS/JS estático, PHP, Node.js e Python. O proxy reverso aparece na documentação e no CLI. No CLI, a documentação pede também o usuário e a senha do site.

O CLI do CloudPanel chama-se clpctl e roda como root. Estes são alguns comandos que a documentação traz (troque domínio, usuário e senha pelos seus):

clpctl site:add:static --domainName=www.domain.com --siteUser=john --siteUserPassword='SENHA-AQUI'

clpctl site:add:php --domainName=www.domain.com --phpVersion=8.4 --vhostTemplate='Generic' --siteUser=john --siteUserPassword='SENHA-AQUI'

clpctl site:add:reverse-proxy --domainName=www.domain.com --reverseProxyUrl='http://127.0.0.1:8000' --siteUser=john --siteUserPassword='SENHA-AQUI'

Antes do comando de PHP, liste os modelos com clpctl vhost-templates:list para escolher o valor de --vhostTemplate. Para um site WordPress, use a interface, porque não encontramos o comando de CLI para isso. Para apagar um site existe clpctl site:delete --domainName=www.domain.com, e com a opção --force ele não pede confirmação, então use essa opção com cuidado.

Aponte o domínio para o servidor

Para o site abrir pelo nome, o domínio precisa apontar para a VPS. A documentação pede um registro DNS válido, sem detalhar o tipo. Um exemplo, que recomendamos conferir no painel de DNS do seu domínio: crie um registro A para @ e outro para www, apontando para o IP da VPS (por exemplo, 203.0.113.10), e um registro AAAA se o servidor tiver IPv6.

Instale o certificado Let's Encrypt

Por padrão, cada site recebe um certificado autoassinado. Segundo a documentação, o certificado gratuito do Let's Encrypt sai pela interface: no site, abra o menu Actions, depois New Let's Encrypt Certificate, adicione os domínios e clique em Create and Install. A condição é ter o registro DNS do domínio já válido. A página de recursos do CloudPanel afirma que a renovação é automática.

Quem usa o proxy da Cloudflare na frente do site não precisa emitir o certificado do Let's Encrypt, segundo a documentação. Por linha de comando, a documentação traz:

clpctl lets-encrypt:install:certificate --domainName=www.domain.com

Para domínios extras no mesmo certificado, acrescente a opção --subjectAlternativeName=domain1.com,www.domain1.com.

Painel com domínio próprio

Em vez do IP e da porta 8443, você pode dar um domínio ao painel. Segundo a documentação, vá em Settings, depois General, e informe o Domain Name. É preciso um registro DNS apontando para o servidor, usado para emitir o Let's Encrypt.

Backups e banco de dados

O CloudPanel tem dois mecanismos de backup, e é bom não confundi-los.

O backup remoto copia o vhost e a pasta home inteira de cada site, menos as pastas .ssh, logs e tmp. É possível excluir outras pastas ou um site inteiro, e há um botão de backup manual. Os destinos que a documentação lista são Amazon S3, Wasabi, DigitalOcean Spaces, Dropbox, Google Drive (que exige conta paga do Google Workspace), Hetzner Storage Box, SFTP e uma configuração própria do Rclone, que fala com mais de 40 produtos de armazenamento. A página não informa frequência nem retenção desses backups remotos, então confira as opções no painel.

O segundo mecanismo é o dump do banco: segundo a documentação, o CloudPanel gera um dump de cada banco toda noite às 3h15, com retenção de 7 dias, em /home/$site-user/backups/. A retenção muda pelo valor retentionPeriod. Como esses arquivos ficam no próprio servidor, recomendamos copiar também para fora dele.

A documentação traz um aviso importante: não use o phpMyAdmin para exportar e importar bancos, porque isso pode destruir o banco. Use o clpctl:

clpctl db:export --databaseName=my-database --file=dump.sql.gz

clpctl db:import --databaseName=my-database --file=dump.sql.gz

Para abrir o acesso remoto ao MySQL, a documentação manda liberar o seu IP para a porta 3306 no Firewall do Admin Area.

Segurança dentro do painel

O painel já vem com regras de firewall pré-configuradas, e o painel permite criar regras para liberar IPs para serviços como SSH, FTP e MySQL. Há também bloqueio de IPs e de robôs indesejados e o Basic Auth. Comandos de CLI da documentação para o painel:

clpctl cloudpanel:enable:basic-auth --userName=john.doe --password='SENHA-AQUI'

clpctl cloudpanel:disable:basic-auth

clpctl user:reset:password --userName=john.doe --password='SENHA-NOVA'

Se desconfiar de invasão, o artigo VPS invadida: o que fazer nas primeiras horas traz os primeiros passos.

Atualize o CloudPanel

A atualização é um único comando, rodado como root:

clp-update

A documentação recomenda criar uma imagem ou um snapshot da instância antes de atualizar.

E-mail: o CloudPanel não tem

O painel não oferece servidor de e-mail. Segundo a documentação, a equipe quer manter o painel enxuto e entende que o e-mail é complexo demais para ficar no servidor das aplicações. A documentação indica serviços como Zoho Mail, Google Workspace (que ela recomenda), Amazon WorkMail, Microsoft 365 e GoDaddy, e cita o Mailcow como solução própria.

Se a ideia é ter um servidor de e-mail seu, o artigo Mailcow na VPS mostra o passo a passo. E se as mensagens dos seus sites estão caindo no spam, veja Email caindo no spam.

Como remover o CloudPanel

Não encontramos desinstalador na documentação. Recomendamos fazer backup dos sites e dos bancos, copiar para fora do servidor e reinstalar o sistema da VPS para voltar ao zero. Antes de reinstalar, confirme que os backups estão fora do servidor.

Endereço dos seus sites

Cada site que você cria no painel responde por um nome de domínio.

Veja se o nome do seu site está disponível para registro na Eleven Host. Buscar domínio

Perguntas frequentes

O CloudPanel é gratuito?

Sim, é gratuito, mas é proprietário. A licença é da empresa que o mantém e os termos podem ser alterados por ela.

Quais sistemas o CloudPanel 2.5.4 suporta?

Ubuntu 26.04, 24.04 e 22.04, e Debian 13 e 12, em x86 e ARM64, segundo a página de requisitos.

O CloudPanel tem servidor de e-mail?

Não. A documentação indica provedores externos ou uma solução própria, como o Mailcow.

Como atualizo o CloudPanel?

Com o comando clp-update, rodado como root, depois de criar um snapshot do servidor.

Esta resposta lhe foi útil?

Artigos Relacionados