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 -yEm 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/nullEm seguida, atualize o repositório e instale o pacote Docker CE usando o seguinte comando.
apt update -y
apt install docker-ce -yUma vez que o Docker CE esteja instalado, você pode verificar a versão do Docker usando o seguinte comando.
docker --versionVocê 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_64Em seguida, copie o binário baixado para o local do sistema.
cp docker-compose-linux-x86_64 /usr/local/bin/docker-composeEm seguida, defina a permissão executável para o binário do Docker Compose.
chmod +x /usr/local/bin/docker-composeEm seguida, verifique a instalação do Docker Compose usando o seguinte comando:
docker-compose --versionVocê 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 dataAgora você pode verificar o volume criado usando o seguinte comando.
docker volume lsVocê 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/portainerVocê 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 psVocê 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:

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

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

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.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.