Tutorial instalar homer com docker compose
Objetivo
Instalar imagem do homer em formato de container com o docker. O Homer é uma dashboard estática muito famosa para utilização em servidores em homelab.
Requisitos
- Software docker instalado e configurado no sistema operacional
- Docker compose instalado e configurado
- Conexão com internet para download da imagem do homer dashboard.
Como instalar imagem do homer com docker
Passo 1: Ter uma pasta dedicada para gerenciar os containers
Caso esteja configurando em linha de comando no linux:
mkdir ~/docker cd ~/docker
Passo 2: Criar uma pasta para armazenar os arquivo de configuração do homer
mkdir ~/docker/homer
Passo 3: Descobrindo o UID e o GID do seu usuário no linux
No terminal utilize o comando para descobrir o UID (user ID):
id -u
Para descobrir o GID (group ID):
id -g
No meu exemplo, meu UID e GID tiveram como resultado o número 1000.
Passo 4: Criar o arquivo de docker compose para o homer
Agora precisamos criar o arquivo docker-compose.yml dentro da pasta ~/docker/filebrowser com o editor de texto conhecido como nano.
nano ~/docker/homer/docker-compose.yml
Dentro do docker-compose.yml é necessário inserir o conteúdo abaixo:
---
version: "2"
services:
homer:
image: b4bz/homer
container_name: homer
volumes:
- ~/docker/homer/data:/www/assets
ports:
- 8080:8080
environment:
- UID=1000
- GID=1000
restart: unless-stopped
Após inserir os dados acima dentro do arquivo docker-compose.yml pelo nano, lembre-se de salvar o arquivo e sair do editor.
Passo 5: Inicializar o container
Caso a imagem do container não esteja disponível (possivelmente não estará) o docker fará o download automaticamente.
Para iniciar a imagem do container com o docker compose, utilize o comando:
cd ~/docker/homer docker compose up -d
Caso esteja utilizando o homer em seu próprio computador, é possível acessá-lo pelo browser, pela url:
http://localhost:porta
Ou se estiver utilizando o mesmo em algum computador remoto ou servidor, basta acessar pelo ip:porta, exemplo:
http://192.168.1.70:8080
Caso já tenha algum serviço funcionando na porta 8080, é necessário editar o arquivo docker-compose.yml e alterar o mapeamento de portas, exemplo:
ports:
- 8085:8080
Desta forma a dashboard do homer ficará disponível na porta 8085.
Passo 6: Customização da dashboard
Após a inicialização do container, terá uma dashboard com dados padrão recém criada.
Para customizar sua dashboard, edite o arquivo:
~/docker/homer/data/config.yml
Se atente que o arquivo é no formato yaml (.yml) e a identação é fundamental. Se não estiver familiarizado em como editar o arquivo, basta seguir o padrão já existente. Lembre-se de ter um backup do arquivo original de config, caso necessite reverter as mudanças.
É possível encontrar diversos ícones para a dashboard em 2 excelentes repositórios no github:
Conclusão
A instalação do container de dashboard do homer é super fácil. Fique atento a qual porta deseja que a mesma funcione, para evitar conflitos com outros serviços.
Para demais comandos utilizando o docker em linha de comando, acesse o artigo: https://viniciuspaes.com/raspberry-pi/tutorial-como-instalar-docker-raspberry-pi/
