O Portainer em poucas teclas
Quatro aliases cuidam do painel. Os atalhos do Docker ajudam a conferir o container.
Subir
Inicie o painel pelo compose do SetupVibe.
portainer-startinicia o Portainer em segundo plano
Conferir
Veja se o container está de pé e leia os logs.
dpslista os containers em execuçãodlog portainersegue os logs do container
Controlar
Pare ou reinicie o painel.
portainer-stoppara o painel do Portainerportainer-restartreinicia o painel do Portainer
Atualizar
Traga a imagem lts mais recente.
portainer-updatebaixa a imagem nova e reinicia o Portainer
Início pelo Docker Compose
No Desktop, portainer-start usa docker compose -f ~/.setupvibe/portainer-compose.yml up -d. A Omarchy fornece sv-portainer-start com esse mesmo arquivo.
Nome e consulta do container
O nome fixado para o container é portainer. Nos arquivos Zsh do Desktop e do Server, dps executa docker ps e dpsa executa docker ps -a. Você pode consultar esses comandos após a instalação.
Comandos de logs
O alias dlog executa docker logs -f no Desktop e no Server. Você pode fornecer o nome portainer para consultar esse container. Na Omarchy, existe a função sv-portainer-logs.
A camada Omarchy fornece as funções sv-portainer-start, sv-portainer-stop e sv-portainer-logs.
O compose do Portainer
O compose fornecido define um serviço chamado portainer. Você pode revisar a imagem, os caminhos montados e a porta antes de iniciar o container.
~/.setupvibe/portainer-compose.ymlservices:
portainer:
image: portainer/portainer-ce:lts
container_name: portainer
restart: always
security_opt:
- no-new-privileges:true
volumes:
- /etc/localtime:/etc/localtime:ro
- /var/run/docker.sock:/var/run/docker.sock
- ./portainer_data:/data
ports:
- 9443:9443Como o SetupVibe sobe o Portainer
O compose usa portainer/portainer-ce:lts, publica 9443:9443 e define restart: always. Ele monta ./portainer_data em /data. No Desktop, a pasta preparada é ~/.setupvibe/portainer_data.
Caminhos montados
O compose monta /etc/localtime em modo de leitura, além de /var/run/docker.sock e ./portainer_data. Você pode revisar esses três caminhos no YAML antes de executar o compose.
Arquivo e pasta do Portainer
Você encontra o compose em ~/.setupvibe/portainer-compose.yml. Os aliases apontam para esse mesmo arquivo. Preserve a pasta ~/.setupvibe/portainer_data antes de alterar ou remover sua instalação.
Limites no compose
O compose fornecido não define limites de CPU ou memória. Você pode conferir o YAML para avaliar os ajustes necessários no seu ambiente.
Antes de abrir o painel
O compose não define acesso remoto, senha nem certificado. Confira três pontos antes de abrir o endereço.
Endereço de acesso
Na própria máquina instalada, você usa
https://localhost:9443. Se o Portainer estiver em uma VPS, localhost no seu navegador aponta para seu computador. Nesse caso, você precisa de acesso de rede ao host instalado ou de um túnel até ele. O SetupVibe não configura esse acesso no compose.Acesso e permissões
O compose publica
9443:9443sem fixar o endereço de loopback. Ele monta o socket Docker e defineno-new-privileges:true. Você deve revisar a publicação da porta e o acesso ao socket antes de iniciar o container, especialmente numa máquina com IP público.Antes de abrir o endereço
Você deve conferir se o Docker está ativo e se o compose foi iniciado antes de abrir o endereço. O arquivo fornecido não declara usuário, senha ou certificado do Portainer. A configuração desses itens deve ser revisada na versão que você instalou.
Portainer em cada edição
Você recebe o arquivo ~/.setupvibe/portainer-compose.yml no Desktop e na Omarchy. As duas edições tentam iniciar o Portainer quando o Docker está disponível. As edições Server e Windows não instalam o Portainer.
Para uma VPS de desenvolvimento, Vibe Coding ou agentes remotos, você usa a edição Desktop. A edição Server atende máquinas que executam aplicações em produção.
