1. Atualize o sistema

Certifique-se de que seus pacotes de sistema estejam atualizados antes de instalar qualquer novo software: 

sudo apt update && sudo apt upgrade -y

2. Instale o Docker Engine

O Portainer funciona como um contêiner e requer uma instalação oficial do Docker Engine (evite pacotes snap para prevenir conflitos de permissões):

# Adiciona a chave GPG e repositório oficial Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo 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/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Instala o Motor Docker (Docker Engine)
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

Verifique se o Docker está instalado e ativo corretamente: 


sudo systemctl status docker

3. Criar um Volume de Dados Portainer

Crie um volume Docker dedicado para garantir a persistência da configuração:

sudo docker volume create portainer_data

4. Implante o contêiner do servidor Portainer

Execute o seguinte comando para baixar e implantar a imagem mais recente do Portainer CE:

sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

-d: Executa o contêiner em modo separado.
-p 9443:9443: Expõe a interface de usuário HTTPS segura.
-v /var/run/docker.sock.: Permite o controle do contêiner sobre o host Docker local.

5. Acesse a interface web do Portainer

5.1. Acesse o endereço https://YOUR_SERVER_IP:9443 no seu navegador web.
5.2. Ignore o aviso de certificado autoassinado.
5.3. Configure seu usuário e senha de administrador iniciais.
5.4. Selecione o ambiente Docker local para gerenciar seu sistema.