Instalação · 3 min read · Oct 05, 2025

Como Instalar o Portainer no Debian 11

O Docker é um motor de contêiner gratuito, de código aberto e o mais popular que permite que os desenvolvedores construam, executem e enviem aplicativos facilmente. No entanto, gerenciar e executar aplicativos em contêiner via linha de comando é muito difícil para qualquer iniciante que não esteja familiarizado com o Docker CLI. É aqui que o Portainer entra em cena. O Portainer é uma plataforma de gerenciamento de contêiner baseada na web que pode trabalhar com Docker e Kubernetes para gerenciar e implantar aplicativos e serviços em contêiner de forma mais fácil e eficiente.

Este tutorial mostrará como instalar o Portainer no servidor Debian 11.

Pré-requisitos

  • Um servidor executando Debian 11.
  • Uma senha de root configurada no servidor.

Instalar Docker CE

Antes de começar, o Docker CE deve ser instalado no seu servidor. Primeiro, instale todas as dependências necessárias usando o seguinte comando.

apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common -y

Em seguida, adicione a chave GPG e o repositório do Docker com o seguinte comando.

curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg  
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

Em seguida, atualize o repositório e instale o pacote Docker CE usando o seguinte comando.

apt update -y  
apt install docker-ce -y

Uma vez que o Docker CE esteja instalado, você pode verificar a versão do Docker usando o seguinte comando.

docker --version

Você receberá a seguinte saída.

Docker version 20.10.23, build 7155243

Instalar Docker Compose

Você também precisará instalar o Docker Compose no seu sistema. Primeiro, baixe a versão mais recente do binário do Docker Compose para o seu sistema usando o seguinte comando.

wget https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64

Em seguida, copie o binário baixado para o local do sistema.

cp docker-compose-linux-x86_64 /usr/local/bin/docker-compose

Em seguida, defina a permissão executável para o binário do Docker Compose.

chmod +x /usr/local/bin/docker-compose

Em seguida, verifique a instalação do Docker Compose usando o seguinte comando:

docker-compose --version

Você deve ver a seguinte saída:

Docker Compose version v2.15.1

Instalar Portainer

Primeiro, crie um volume para armazenar os dados do Portainer usando o seguinte comando.

docker volume create data

Agora você pode verificar o volume criado usando o seguinte comando.

docker volume ls

Você receberá a seguinte saída.

DRIVER    VOLUME NAME
local     data

Em seguida, execute o seguinte comando para baixar e executar a imagem do Docker do Portainer.

docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v data:/data portainer/portainer

Você receberá a seguinte saída.

latest: Pulling from portainer/portainer
772227786281: Pull complete 
96fd13befc87: Pull complete 
0bad1d247b5b: Pull complete 
b5d1b01b1d39: Pull complete 
Digest: sha256:47b064434edf437badf7337e516e07f64477485c8ecc663ddabbe824b20c672d
Status: Downloaded newer image for portainer/portainer:latest
e0ee5b16c93f358a15dfcb93cc80d2c2d1c1c675e7b65e41434ce20f08773465

Você pode verificar o status do Portainer usando o seguinte comando.

docker ps

Você receberá a seguinte saída.

CONTAINER ID   IMAGE                 COMMAND        CREATED          STATUS          PORTS                                                                                            NAMES
e0ee5b16c93f   portainer/portainer   "/portainer"   28 seconds ago   Up 27 seconds   0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp, 9443/tcp   portainer

Acessar a Interface Web do Portainer

Neste ponto, o Portainer está instalado e em execução na porta 9000. Você pode acessá-lo usando a URL http://your-server-ip:9000. Você receberá a seguinte página:

Login do Portainer

Defina seu nome de usuário de administrador, senha e clique no botão Criar usuário. Você deve ver a seguinte página:

Painel do Portainer

Clique no botão Começar para ver o status de todos os contêineres locais.

Ambientes do Portainer

Conclusão

Parabéns! Você instalou com sucesso o Portainer no servidor Debian 11. Agora você pode facilmente hospedar seu aplicativo na plataforma de contêinerização através de uma interface baseada na web. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.