--- title: "Como instalar o Portainer na VPS (Docker) | RoxyCloud" description: "Instale o Portainer CE na VPS com um comando Docker, crie o administrador, proteja o painel e gerencie containers, imagens, volumes e stacks pelo navegador." url: "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps" category: "servidor-vps-cloud" categoryLabel: "Servidor VPS (Cloud)" slug: "como-instalar-portainer-vps" datePublished: "2026-09-18" dateModified: "2026-09-18" author: "Equipe RoxyCloud" language: "pt-BR" readingMinutes: 5 json: "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps.json" --- # Como instalar o Portainer na VPS para gerenciar o Docker Instale o Portainer CE na VPS com um comando Docker, crie o administrador, proteja o painel e gerencie containers, imagens, volumes e stacks pelo navegador. **Resposta rápida:** com o Docker instalado, crie um volume (`docker volume create portainer_data`) e suba o Portainer CE com `docker run` na porta **9443** (HTTPS). Abra `https://IP_DA_VPS:9443` e crie o usuário administrador **nos primeiros minutos**. Depois, restrinja o acesso ao painel, porque ele controla todos os containers da VPS. ## O que é o Portainer O Portainer é um painel web para Docker. Em vez de decorar comandos, você sobe, para e inspeciona containers pelo navegador, vê logs em tempo real e administra imagens, volumes, redes e stacks do Docker Compose. É muito usado para rodar n8n, Evolution API, bancos de dados e outros serviços em VPS. A edição **Community (CE)** é gratuita e de código aberto, e é a usada neste guia. ## Pré-requisitos - VPS com Ubuntu ou Debian e acesso root ou sudo. - Docker instalado e rodando. Se ainda não tem, siga [como instalar Docker no Ubuntu e no Debian](https://ajuda.roxycloud.com.br/artigos/instalar-docker-ubuntu-debian) . - Pelo menos 1 GB de RAM livre para o Portainer e os primeiros containers. Confira o Docker com `sudo docker version` antes de seguir. ## Instalar o Portainer CE 1. Crie o volume onde o Portainer guarda usuários e configurações: `sudo docker volume create portainer_data` 2. Suba o container: `sudo docker run -d \ -p 9443:9443 \ --name portainer \ --restart=always \ -v /var/run/docker.sock:/var/run/docker.sock \ -v portainer_data:/data \ portainer/portainer-ce:lts` 3. Confira se está rodando: `sudo docker ps --filter name=portainer` A tag `lts` segue a versão de suporte estendido, a mais estável. A porta 9443 serve o painel em HTTPS com um certificado autoassinado, então o navegador vai mostrar um aviso de segurança no primeiro acesso; isso é esperado. A porta 8000 só é necessária para o recurso Edge Agent, que não é usado aqui. ## Primeiro acesso e usuário administrador Libere a porta no firewall, de preferência só para o seu IP: ``` sudo ufw allow from SEU_IP to any port 9443 proto tcp ``` Atenção: portas publicadas pelo Docker podem continuar acessíveis mesmo com essa regra do UFW (veja a seção de segurança). Para restringir de verdade, publique o painel só em `127.0.0.1` e acesse por túnel SSH ou por um domínio com proxy reverso. Abra `https://IP_DA_VPS:9443`, aceite o aviso do certificado e crie o administrador com uma senha forte (o Portainer exige no mínimo 12 caracteres). Em seguida, escolha o ambiente local (*Get Started*) para gerenciar o Docker da própria VPS. > **Importante:** crie o administrador logo após subir o container. Por segurança, o Portainer desativa a tela de criação depois de alguns minutos sem uso; se isso acontecer, reinicie o container com `sudo docker restart portainer` e acesse de novo. ## Segurança do painel Quem entra no Portainer controla todos os containers e pode acessar dados, variáveis e senhas. Trate o acesso como crítico: - **Restrinja por IP** no firewall, como no comando acima, em vez de abrir a porta para todos. - **Use senha forte** e, se possível, um usuário administrador por pessoa. - **Coloque atrás de um domínio com HTTPS válido** , usando o Nginx como proxy reverso e certificado Let's Encrypt. Veja [como instalar o Nginx](https://ajuda.roxycloud.com.br/artigos/instalar-nginx-linux) . - **Atenção ao Docker e ao UFW:** portas publicadas pelo Docker com `-p` podem ficar acessíveis mesmo com regras do UFW, porque o Docker cria as próprias regras de firewall. Para deixar o painel só no proxy local, publique com `-p 127.0.0.1:9443:9443` e acesse pelo domínio. - **Mantenha atualizado:** versões antigas acumulam falhas conhecidas. ## Atualizar o Portainer Os dados ficam no volume `portainer_data`, então atualizar é trocar o container: ```bash sudo docker stop portainer sudo docker rm portainer sudo docker pull portainer/portainer-ce:lts sudo docker run -d -p 9443:9443 --name portainer --restart=always \ -v /var/run/docker.sock:/var/run/docker.sock \ -v portainer_data:/data \ portainer/portainer-ce:lts ``` ## Uso no dia a dia - **Stacks:** cole um arquivo `docker-compose.yml` e suba vários serviços de uma vez, como n8n com PostgreSQL. - **Logs e console:** veja os logs de cada container e abra um terminal dentro dele pelo navegador. - **Estatísticas:** acompanhe CPU e memória por container. - **Limpeza:** remova imagens e volumes que não são mais usados. Antes de apagar volumes, confira a quem pertencem, porque guardam dados de bancos. Para acompanhar o consumo da máquina inteira, use também o guia de [htop e Netdata](https://ajuda.roxycloud.com.br/artigos/htop-e-netdata-monitorar-vps). Se o disco encher com imagens antigas, veja [como descobrir o que ocupa espaço na VPS](https://ajuda.roxycloud.com.br/artigos/disco-cheio-linux-ver-espaco-vps). ## Qual VPS usar na RoxyCloud O Portainer em si é leve. O que define o plano são os containers que você vai rodar: | Uso | Plano sugerido | | --- | --- | | Portainer com um ou dois serviços leves | VPS Xeon 2 GB | | n8n com PostgreSQL, Evolution API ou bots | VPS Xeon 4 a 8 GB | | Muitos containers ou serviços que pedem CPU rápida | VPS Ryzen 9 8 GB ou mais | Todas as VPS da RoxyCloud usam KVM, com Docker funcionando de forma nativa, acesso root, IPv4 dedicado e Anti-DDoS incluso. Para automações, há também a página [VPS para n8n](https://roxycloud.com.br/vps-n8n), com Ubuntu 24.04 pronto para instalar Docker e Portainer. ## Perguntas frequentes **O Portainer é gratuito?** A edição Community (CE) é gratuita e de código aberto. Existe também a Business Edition, paga, com recursos extras para empresas. **Qual porta o Portainer usa?** A 9443 para o painel em HTTPS. A 9000 (HTTP) é usada só em instalações antigas ou quando ativada manualmente, e a 8000 só no recurso Edge Agent. **É seguro deixar o Portainer exposto na internet?** Não sem proteção. Ele controla todos os containers. Use senha forte, restrinja por IP e, de preferência, acesse por um domínio com HTTPS via proxy reverso. **O Portainer substitui a linha de comando do Docker?** Para o dia a dia, em boa parte sim. Para tarefas avançadas, a linha de comando continua útil, mas o painel reduz muito o trabalho. **Esqueci a senha do Portainer, e agora?** É possível redefinir com a ferramenta oficial de reset de senha do Portainer, rodando um container auxiliar com o volume de dados. Pare o Portainer antes e siga a documentação oficial. ## Guias relacionados - [RDP não conecta na VPS Windows? Use o console VNC do painel](https://ajuda.roxycloud.com.br/artigos/console-vnc-vps-windows-rdp-nao-conecta.md) - [Disco cheio no Linux: como ver o que ocupa espaço na VPS](https://ajuda.roxycloud.com.br/artigos/disco-cheio-linux-ver-espaco-vps.md) - [Como monitorar uma VPS 24 horas: alertas, uptime e métricas](https://ajuda.roxycloud.com.br/artigos/monitorar-vps-24-horas.md) - [Como monitorar a VPS com htop e Netdata](https://ajuda.roxycloud.com.br/artigos/htop-e-netdata-monitorar-vps.md) - [SCP e rsync: como transferir arquivos para a VPS](https://ajuda.roxycloud.com.br/artigos/scp-e-rsync-transferir-arquivos-vps.md) ## Produtos citados - https://roxycloud.com.br/vps-n8n ## Fonte Central de Ajuda RoxyCloud: https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps ## Dados estruturados ```json [ { "@type": "Article", "@id": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps#article", "headline": "Como instalar o Portainer na VPS (Docker)", "description": "Instale o Portainer CE na VPS com um comando Docker, crie o administrador, proteja o painel e gerencie containers, imagens, volumes e stacks pelo navegador.", "url": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps", "articleSection": "Servidor VPS (Cloud)", "inLanguage": "pt-BR", "isAccessibleForFree": true, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps#webpage" }, "image": [ "https://ajuda.roxycloud.com.br/og-ajuda.png" ], "author": { "@type": "Organization", "name": "RoxyCloud" }, "publisher": { "@type": "Organization", "name": "RoxyCloud", "logo": { "@type": "ImageObject", "url": "https://cdn.roxycloud.com.br/logo.png" } }, "datePublished": "2026-09-18T21:29:03.000Z", "dateModified": "2026-09-18T21:56:03.000Z" }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://ajuda.roxycloud.com.br" }, { "@type": "ListItem", "position": 2, "name": "Servidor VPS (Cloud)", "item": "https://ajuda.roxycloud.com.br/categorias/servidor-vps-cloud" }, { "@type": "ListItem", "position": 3, "name": "Como instalar o Portainer na VPS para gerenciar o Docker", "item": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps" } ] }, { "@type": "FAQPage", "@id": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps#faq", "mainEntity": [ { "@type": "Question", "name": "O Portainer é gratuito?", "acceptedAnswer": { "@type": "Answer", "text": "A edição Community (CE) é gratuita e de código aberto. Existe também a Business Edition, paga, com recursos extras para empresas." } }, { "@type": "Question", "name": "Qual porta o Portainer usa?", "acceptedAnswer": { "@type": "Answer", "text": "A 9443 para o painel em HTTPS. A 9000 (HTTP) é usada só em instalações antigas ou quando ativada manualmente, e a 8000 só no recurso Edge Agent." } }, { "@type": "Question", "name": "É seguro deixar o Portainer exposto na internet?", "acceptedAnswer": { "@type": "Answer", "text": "Não sem proteção. Ele controla todos os containers. Use senha forte, restrinja por IP e, de preferência, acesse por um domínio com HTTPS via proxy reverso." } }, { "@type": "Question", "name": "O Portainer substitui a linha de comando do Docker?", "acceptedAnswer": { "@type": "Answer", "text": "Para o dia a dia, em boa parte sim. Para tarefas avançadas, a linha de comando continua útil, mas o painel reduz muito o trabalho." } }, { "@type": "Question", "name": "Esqueci a senha do Portainer, e agora?", "acceptedAnswer": { "@type": "Answer", "text": "É possível redefinir com a ferramenta oficial de reset de senha do Portainer, rodando um container auxiliar com o volume de dados. Pare o Portainer antes e siga a documentação oficial." } } ] } ] ```