{
  "schemaVersion": "1.0",
  "id": 149,
  "path": "/artigos/como-instalar-portainer-vps",
  "url": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps",
  "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps.md",
  "jsonUrl": "https://ajuda.roxycloud.com.br/artigos/como-instalar-portainer-vps.json",
  "title": "Como instalar o Portainer na VPS para gerenciar o Docker",
  "seoTitle": "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.",
  "category": "servidor-vps-cloud",
  "categoryLabel": "Servidor VPS (Cloud)",
  "categoryUrl": "https://ajuda.roxycloud.com.br/categorias/servidor-vps-cloud",
  "datePublished": "2026-09-18",
  "dateModified": "2026-09-18",
  "readingMinutes": 5,
  "wordCount": 954,
  "h1": "Como instalar o Portainer na VPS para gerenciar o Docker",
  "excerpt": "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.",
  "author": "Equipe RoxyCloud",
  "language": "pt-BR",
  "toc": [
    {
      "id": "o-que-e-o-portainer",
      "label": "O que é o Portainer",
      "level": 2
    },
    {
      "id": "pre-requisitos",
      "label": "Pré-requisitos",
      "level": 2
    },
    {
      "id": "instalar-o-portainer-ce",
      "label": "Instalar o Portainer CE",
      "level": 2
    },
    {
      "id": "primeiro-acesso-e-usuario-administrador",
      "label": "Primeiro acesso e usuário administrador",
      "level": 2
    },
    {
      "id": "seguranca-do-painel",
      "label": "Segurança do painel",
      "level": 2
    },
    {
      "id": "atualizar-o-portainer",
      "label": "Atualizar o Portainer",
      "level": 2
    },
    {
      "id": "uso-no-dia-a-dia",
      "label": "Uso no dia a dia",
      "level": 2
    },
    {
      "id": "qual-vps-usar-na-roxycloud",
      "label": "Qual VPS usar na RoxyCloud",
      "level": 2
    },
    {
      "id": "perguntas-frequentes",
      "label": "Perguntas frequentes",
      "level": 2
    }
  ],
  "faqs": [
    {
      "question": "O Portainer é gratuito?",
      "answer": "A edição Community (CE) é gratuita e de código aberto. Existe também a Business Edition, paga, com recursos extras para empresas."
    },
    {
      "question": "Qual porta o Portainer usa?",
      "answer": "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."
    },
    {
      "question": "É seguro deixar o Portainer exposto na internet?",
      "answer": "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."
    },
    {
      "question": "O Portainer substitui a linha de comando do Docker?",
      "answer": "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."
    },
    {
      "question": "Esqueci a senha do Portainer, e agora?",
      "answer": "É 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."
    }
  ],
  "howToSteps": [
    "Crie o volume onde o Portainer guarda usuários e configurações: sudo docker volume create portainer_data",
    "Suba o container: TerminalCopiarsudo 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",
    "Confira se está rodando: sudo docker ps --filter name=portainer"
  ],
  "relatedGuides": [
    {
      "title": "RDP não conecta na VPS Windows? Use o console VNC do painel",
      "url": "https://ajuda.roxycloud.com.br/artigos/console-vnc-vps-windows-rdp-nao-conecta",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/console-vnc-vps-windows-rdp-nao-conecta.md"
    },
    {
      "title": "Disco cheio no Linux: como ver o que ocupa espaço na VPS",
      "url": "https://ajuda.roxycloud.com.br/artigos/disco-cheio-linux-ver-espaco-vps",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/disco-cheio-linux-ver-espaco-vps.md"
    },
    {
      "title": "Como monitorar uma VPS 24 horas: alertas, uptime e métricas",
      "url": "https://ajuda.roxycloud.com.br/artigos/monitorar-vps-24-horas",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/monitorar-vps-24-horas.md"
    },
    {
      "title": "Como monitorar a VPS com htop e Netdata",
      "url": "https://ajuda.roxycloud.com.br/artigos/htop-e-netdata-monitorar-vps",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/htop-e-netdata-monitorar-vps.md"
    },
    {
      "title": "SCP e rsync: como transferir arquivos para a VPS",
      "url": "https://ajuda.roxycloud.com.br/artigos/scp-e-rsync-transferir-arquivos-vps",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/scp-e-rsync-transferir-arquivos-vps.md"
    }
  ],
  "relatedProducts": [
    "https://roxycloud.com.br/vps-n8n"
  ],
  "content": {
    "format": "markdown",
    "body": "**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.\n\n## O que é o Portainer\n\nO 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.\n\nA edição **Community (CE)** é gratuita e de código aberto, e é a usada neste guia.\n\n## Pré-requisitos\n\n- VPS com Ubuntu ou Debian e acesso root ou sudo.\n- 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) .\n- Pelo menos 1 GB de RAM livre para o Portainer e os primeiros containers.\n\nConfira o Docker com `sudo docker version` antes de seguir.\n\n## Instalar o Portainer CE\n\n1. Crie o volume onde o Portainer guarda usuários e configurações: `sudo docker volume create portainer_data`\n2. Suba o container: `sudo docker run -d \\\n  -p 9443:9443 \\\n  --name portainer \\\n  --restart=always \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  -v portainer_data:/data \\\n  portainer/portainer-ce:lts`\n3. Confira se está rodando: `sudo docker ps --filter name=portainer`\n\nA 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.\n\n## Primeiro acesso e usuário administrador\n\nLibere a porta no firewall, de preferência só para o seu IP:\n\n```\nsudo ufw allow from SEU_IP to any port 9443 proto tcp\n```\n\nAtençã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.\n\nAbra `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.\n\n> **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.\n\n## Segurança do painel\n\nQuem entra no Portainer controla todos os containers e pode acessar dados, variáveis e senhas. Trate o acesso como crítico:\n\n- **Restrinja por IP** no firewall, como no comando acima, em vez de abrir a porta para todos.\n- **Use senha forte** e, se possível, um usuário administrador por pessoa.\n- **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) .\n- **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.\n- **Mantenha atualizado:** versões antigas acumulam falhas conhecidas.\n\n## Atualizar o Portainer\n\nOs dados ficam no volume `portainer_data`, então atualizar é trocar o container:\n\n```bash\nsudo docker stop portainer\nsudo docker rm portainer\nsudo docker pull portainer/portainer-ce:lts\nsudo docker run -d -p 9443:9443 --name portainer --restart=always \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  -v portainer_data:/data \\\n  portainer/portainer-ce:lts\n```\n\n## Uso no dia a dia\n\n- **Stacks:** cole um arquivo `docker-compose.yml` e suba vários serviços de uma vez, como n8n com PostgreSQL.\n- **Logs e console:** veja os logs de cada container e abra um terminal dentro dele pelo navegador.\n- **Estatísticas:** acompanhe CPU e memória por container.\n- **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.\n\nPara 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).\n\n## Qual VPS usar na RoxyCloud\n\nO Portainer em si é leve. O que define o plano são os containers que você vai rodar:\n\n| Uso | Plano sugerido |\n| --- | --- |\n| Portainer com um ou dois serviços leves | VPS Xeon 2 GB |\n| n8n com PostgreSQL, Evolution API ou bots | VPS Xeon 4 a 8 GB |\n| Muitos containers ou serviços que pedem CPU rápida | VPS Ryzen 9 8 GB ou mais |\n\nTodas 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.\n\n## Perguntas frequentes\n\n**O Portainer é gratuito?**\n\nA edição Community (CE) é gratuita e de código aberto. Existe também a Business Edition, paga, com recursos extras para empresas.\n\n**Qual porta o Portainer usa?**\n\nA 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.\n\n**É seguro deixar o Portainer exposto na internet?**\n\nNã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.\n\n**O Portainer substitui a linha de comando do Docker?**\n\nPara 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.\n\n**Esqueci a senha do Portainer, e agora?**\n\nÉ 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."
  },
  "jsonLd": [
    {
      "@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."
          }
        }
      ]
    }
  ]
}