Pular para o conteúdo
EntrarCriar minha VPS

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.

cerca de 10 minjunho/2026 · Ubuntu 24.04 LTS

Antes de começar

VPS mínima
1 vCPU · 1 GB RAM · 10 GB SSD (Runstack Micro)
Sistema
Ubuntu 24.04 LTS
Também
  • Docker instalado e rodando (veja /tutorial/como-instalar-docker)
  • Porta 9443 ou 9000 acessível no firewall

Instalação passo a passo

  1. 1

    Atualizar o sistema e verificar Docker

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

    bash
    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.

    bash
    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.

    bash
    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
  4. 4

    Verificar que o container subiu

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

    bash
    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.

    bash
    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.

  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.

Não quer configurar manualmente?

Implante o Portainer em menos de 5 minutos com a Runstack. Infraestrutura da OPEN Datacenter, com servidores em São Paulo.

Criar minha VPSVer apps prontos

Se der problema

Verifique se o UFW está liberando a porta e se o container está rodando.

bash
ufw status | grep 9443
docker ps | grep portainer

Se o container foi reiniciado após os 5 minutos do setup inicial, remova e recrie o container com um volume limpo.

bash
docker stop portainer && docker rm portainer
docker volume rm portainer_data
docker volume create portainer_data
# Execute novamente o docker run do passo 3

O volume /var/run/docker.sock deve estar mapeado corretamente. Verifique se o socket existe no host.

bash
ls -la /var/run/docker.sock

O Portainer usa um certificado autoassinado por padrão. Clique em "Avançado" → "Prosseguir para IP" no navegador. Para usar um certificado real, configure um domínio e use a opção `--sslcert` e `--sslkey` no docker run.

Verifique se as variáveis de ambiente estão configuradas na stack e se as imagens existem. Veja os logs da stack na interface do Portainer.

Perguntas frequentes

Sim. A versão Community Edition é completamente gratuita para uso pessoal e comercial. A versão Business Edition adiciona controle de acesso granular, registros de auditoria e suporte técnico.

Sim. Instale o Portainer Agent nos outros servidores e adicione-os como endpoints no painel central. O agente é gerenciado via porta 9001.

No menu lateral, acesse Stacks → Add Stack → Web editor. Cole o conteúdo do docker-compose.yml e clique em Deploy the stack.

Sim. O Portainer suporta Docker Standalone, Docker Swarm e Kubernetes. Selecione o tipo de ambiente na configuração inicial.

Pare e remova o container, faça pull da nova imagem e recrie: `docker stop portainer && docker rm portainer && docker pull portainer/portainer-ce:latest` e execute novamente o docker run. Os dados persistem no volume portainer_data.

Continue lendo