Guia Completo: Como Instalar o Portainer no OpenMediaVault (OMV)

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!