Como instalar o Portainer CE em uma VPS Ubuntu

O Portainer Community Edition é uma interface web gratuita para gerenciar containers Docker, volumes, redes e stacks. Este guia instala o Portainer CE com os comandos oficiais da documentação docs.portainer.io.

Instalação passo a passo

1. 1

   Atualizar o sistema e verificar Docker

   Confirme que Docker está instalado e rodando antes de prosseguir.

   bashCopiar

   apt update && apt upgrade -y
   docker --version
   systemctl status docker

2. 2

   Criar o volume de dados do Portainer

   O Portainer armazena sua configuração em um volume Docker dedicado.

   bashCopiar

   docker volume create portainer_data

3. 3

   Instalar o Portainer CE

   Execute o container do Portainer com os parâmetros oficiais. A porta 9443 é HTTPS e 9000 é HTTP.

   bashCopiar

   docker run -d \
     -p 8000:8000 \
     -p 9443:9443 \
     --name portainer \
     --restart=always \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -v portainer_data:/data \
     portainer/portainer-ce:latest

   Dica

   A porta 8000 é usada para comunicação com agentes Portainer remotos. A porta 9443 é a interface HTTPS com certificado autoassinado. A porta 9000 (HTTP) não é mapeada por padrão — use 9443.
4. 4

   Verificar que o container subiu

   Confirme que o Portainer está rodando antes de acessar pelo navegador.

   bashCopiar

   docker ps | grep portainer
   docker logs portainer --tail=20

5. 5

   Configurar firewall UFW

   Libere a porta 9443 para acesso ao painel. A porta 8000 só é necessária para agentes remotos.

   bashCopiar

   ufw allow 22/tcp comment 'SSH'
   ufw allow 9443/tcp comment 'Portainer HTTPS'
   # Opcional: liberar porta 8000 apenas se usar agentes remotos
   # ufw allow 8000/tcp comment 'Portainer Agent'
   ufw --force enable
   ufw status verbose

6. 6

   Criar conta de administrador

   Acesse o Portainer pelo navegador e configure o usuário administrador.

   Dica

   Acesse https://IP-DA-VPS:9443 no navegador. O certificado é autoassinado — aceite o aviso de segurança. O Portainer solicita a criação do usuário admin no primeiro acesso. Atenção: se não criar a conta em até 5 minutos após a instalação, o Portainer se desativa por segurança e precisa ser reiniciado.

   Atenção

   Crie a conta de administrador IMEDIATAMENTE após a instalação. O Portainer encerra o servidor de setup após 5 minutos de inatividade.
7. 7

   Conectar ao ambiente Docker local

   No primeiro acesso, o Portainer solicita a configuração do ambiente Docker. Selecione "Docker standalone" e confirme para gerenciar o Docker do próprio servidor.

   Dica

   Após configurar o ambiente, você verá os containers, volumes e redes já existentes no servidor. O socket /var/run/docker.sock mapeado no container dá ao Portainer acesso ao Docker do host.

Troubleshooting

Perguntas frequentes