O que o Portainer gerencia num ambiente
O dashboard do Portainer é o resumo dos recursos de um ambiente Docker. Ele reúne o estado dos containers e os totais por categoria, para você localizar uma stack ou abrir os detalhes de um recurso da sua VPS.
Ficha e sumário da página
- Referência técnica
- Portainer 2.45.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
As categorias da API do Docker
O Docker guarda cada coisa que você cria num tipo próprio de objeto. Um container é um processo isolado, uma imagem é o sistema de arquivos de onde o container parte, um volume guarda arquivos fora do ciclo de vida do container e uma rede liga containers entre si. O Portainer não inventa outra organização para esses objetos. O menu de um ambiente segue as categorias da API do Docker, com a stack por cima, porque a stack agrupa os outros recursos de um mesmo app.
Ao escolher um ambiente na tela inicial, você entra no dashboard dele. Num Docker Standalone, o topo mostra o nome do ambiente, o endereço, a quantidade de núcleos de CPU, a memória disponível, a versão do Docker e se o Portainer Agent está instalado. Abaixo ficam os blocos de resumo:
Ambiente localO Docker do servidor, lido pelo socket.StacksOs apps descritos em arquivos no formato do Compose.ContainersO total, com os que rodam, os parados e o estado de saúde.ImagesAs imagens baixadas, com o espaço que ocupam em disco.VolumesOs volumes do Docker, ligados ou não a um container.NetworksAs redes do Docker, inclusive a rede que o proxy compartilha.
Cada bloco abre a lista correspondente ao ambiente escolhido. A atualização dessa lista depende da conexão com o ambiente. No modo Edge Async, por exemplo, você consulta uma captura enviada pelo agente, que pode ser anterior ao estado atual do Docker.
Containers
A tela de detalhes de um container junta o que o terminal espalha por vários comandos. Você vê o estado, a imagem, as portas, as variáveis e os volumes montados. Na mesma tela ficam as ações do dia a dia, que chegam ao Docker como as chamadas equivalentes do docker:
- LogsA saída do container, a mesma do comando docker logs.
- StatsO uso de CPU, de memória e de rede em tempo real.
- ConsoleUm terminal dentro do container, aberto pelo navegador.
- InspectO JSON completo que o Docker devolve sobre o container.
O painel também edita e duplica um container. A edição pelo painel recria o container com as configurações novas, porque o Docker não altera porta ou volume de um container em execução. Num container que pertence a uma stack, a mudança feita fora do arquivo da stack some na próxima atualização dela. Para apps dos portais da Promovaweb, a edição acontece no arquivo da stack.
Imagens, volumes e redes
A tela de imagens lista o que já foi baixado no servidor, com o tamanho de cada imagem. Por ela você baixa uma imagem nova de um registry, constrói uma imagem a partir de um Dockerfile, importa e exporta arquivos de imagem. Numa VPS com pouco disco, essa lista mostra as imagens antigas que ficaram para trás depois das atualizações das stacks.
Os volumes merecem atenção especial, porque guardam os arquivos que sobrevivem à remoção do container, como os arquivos do PostgreSQL ou as credenciais do n8n. O Portainer mostra cada volume e o container que o usa. A remoção de um volume pelo painel apaga os arquivos dele no disco, do mesmo jeito que o docker volume rm.
A tela de redes mostra as redes do Docker e os containers ligados a cada uma. Nas stacks dos portais, essa leitura confirma se o serviço web de um app entrou na rede compartilhada com o Traefik e se o banco ficou só na rede interna da própria stack, divisão que a página O Traefik nas stacks dos portais detalha.
Stacks e o indicador de imagem nova
A lista de stacks mostra as stacks criadas no ambiente. A Business Edition oferece um indicador de imagem nova, ativado nas configurações do ambiente. Ele compara o digest da imagem local com o do registry. Um sinal verde indica imagens em dia, um x laranja avisa que o registry tem uma imagem diferente para a mesma tag e um traço cinza indica que o Portainer não conseguiu fazer a comparação. Esse indicador fica fora da Community Edition.
O indicador compara a mesma tag. Uma stack que usa a tag lts de uma imagem recebe o aviso quando o registry publica uma nova imagem sob essa tag. Uma tag fixa de versão, como 2.45.3, não acusa a linha seguinte. A página Stacks pelo painel explica como o Portainer guarda e atualiza cada stack.
Templates
Os templates são modelos prontos para subir um container ou uma stack. Os templates de aplicação vêm de uma lista definida nas configurações do Portainer. Os templates personalizados você cria a partir de um arquivo no formato do Compose ou de uma stack já implantada. Eles servem para repetir a mesma stack em outro ambiente sem copiar o arquivo à mão.
Recursos criados fora do painel
O Portainer marca como externo todo recurso criado direto no Docker, pelo terminal ou por outra ferramenta. Esses recursos aparecem nas listas, mas o controle sobre eles fica limitado. Por padrão, só os administradores do Portainer os enxergam. Labels como io.portainer.accesscontrol.teams liberam o acesso a um team, como mostra a página Usuários, teams e permissões.
Os recursos que você enxerga dentro de um ambiente dependem de como o Portainer Server alcança esse servidor, assunto da página Ambientes e agentes.