Introdução
O Portainer é uma ferramenta de gerenciamento de containers Docker com interface web, projetada para simplificar a administração de infraestruturas de containers. Para usuários do OpenMediaVault (OMV), o Portainer é quase indispensável. Ele permite que você crie, gerencie, monitore e atualize seus containers sem a necessidade de utilizar a linha de comando constantemente.
Neste guia técnico, vamos detalhar o passo a passo para instalar o Portainer no seu servidor OMV de forma segura e eficiente.
—
Pré-requisitos
Antes de começar, certifique-se de que você possui:
1. Um sistema OpenMediaVault instalado e funcional.
2. Os plugins Docker e Compose instalados e ativos através da interface web do OMV.
3. Acesso via SSH ou através do terminal do WebGUI do OMV.
—
Passo 1: Preparando o Ambiente
Embora o OMV facilite a instalação do Docker, é recomendável garantir que o Docker esteja rodando corretamente. Verifique a versão com o comando:
docker --version
Passo 2: Criando o Volume de Dados
É uma boa prática separar os dados do Portainer em um volume dedicado. Isso garante que suas configurações não sejam perdidas caso você remova o container.
Execute o seguinte comando no terminal:
docker volume create portainer_data
Passo 3: Criando o arquivo Docker Compose
O uso do Docker Compose é o método mais limpo e reutilizável para subir o Portainer.
1. Crie uma pasta para o Portainer (ex: /home/admin/docker/portainer ou dentro de um caminho de montagem do seu HD).
2. Crie um arquivo chamado docker-compose.yml dentro dessa pasta.
3. Cole o seguinte conteúdo:
version: '3.0'
services:
portainer:
image: portainer/portainer-ce:latest
container_name: portainer
restart: always
security_opt:
- no-new-privileges:true
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- portainer_data:/data
ports:
- "9000:9000"
- "9443:9443"volumes: portainer_data: external: true
Nota: O volume portainer_data deve ser o mesmo nome que você criou no Passo 2.
Passo 4: Iniciando o Portainer
Navegue até a pasta onde você salvou o arquivo e execute:
docker-compose up -d
O Docker irá baixar a imagem e iniciar o container. O Portainer estará disponível nas portas 9000 (HTTP) e 9443 (HTTPS).
Passo 5: Configuração Inicial
1. Abra seu navegador e digite o IP do seu servidor seguido da porta: https://IP-DO-SERVIDOR:9443
2. Você verá um aviso de certificado SSL (pois é autoassinado). Clique em “Avançado” e “Prosseguir”.
3. Crie sua conta de administrador (usuário e senha).
4. Selecione o ambiente local para começar a gerenciar seus containers.
—
Melhores Práticas
– Segurança: Sempre altere as portas padrão se o seu servidor estiver exposto à internet (o que não é recomendado).
– Backups: Faça backups regulares da pasta onde seus arquivos docker-compose.yml estão armazenados.
– Atualizações: Para atualizar o Portainer, basta rodar docker-compose pull seguido de docker-compose up -d.
—
FAQ (Perguntas Frequentes)
1. Por que não consigo acessar a interface web?
Verifique se o firewall do seu roteador ou do próprio OMV está bloqueando as portas 9000 ou 9443.
2. O Portainer apaga meus dados se eu deletar o container?
Não, desde que você tenha mapeado corretamente o volume portainer_data.
3. Posso rodar o Portainer em uma porta diferente?
Sim, basta alterar o lado esquerdo do mapeamento de portas no arquivo docker-compose.yml (ex: “8080:9000”).
—
Conclusão
Agora que o Portainer está instalado, você tem uma ferramenta poderosa para gerenciar seus serviços no OpenMediaVault. A partir daqui, você pode instalar aplicativos como Pi-hole, Home Assistant e outros com apenas alguns cliques.
Gostou deste guia? Compartilhe com outros usuários de OMV e comece a dominar seus containers hoje mesmo!