Introdução

O Homepage é um software que funciona como uma página inicial personalizada para servidores domésticos. Ele serve para organizar e centralizar o acesso a diversos serviços que rodam em uma mesma máquina ou rede. Em vez de decorar endereços IP e números de portas diferentes (como 192.168.2.14:4533 ou 192.168.2.14:8384), o usuário acessa uma única página web que contém ícones e links para todas as suas ferramentas.

Para que serve?

Em um servidor com sistema Linux, é comum instalar vários programas que possuem interface web. Conforme a quantidade de serviços cresce, a tarefa de gerenciar os endereços de acesso se torna confusa. O Homepage resolve isso criando uma interface visual limpa, onde o administrador pode agrupar serviços por categorias, monitorar o uso de processador (CPU) e memória RAM, e visualizar o status de cada aplicação em tempo real.

Pré-requisitos

Para seguir este procedimento, é necessário ter o Docker e o Docker Compose instalados no sistema. No caso deste exemplo, utilizamos um sistema Gentoo com systemd, mas os comandos funcionam em qualquer distribuição que suporte Docker.

Passo 1: Organização dos diretórios

O primeiro passo é criar uma pasta para guardar os arquivos de configuração do painel. Manter os arquivos organizados facilita a manutenção e o backup. Execute os comandos no terminal:

Passo 2: Configuração do Docker Compose

O Docker Compose é uma ferramenta que utiliza um arquivo de "receita" para subir o serviço. Vamos criar o arquivo docker-compose.yml. Note que utilizamos a porta 3001 para o acesso e definimos uma variável de segurança para permitir o acesso pelo endereço IP da rede local.

Passo 3: Configuração dos serviços

Agora vamos configurar o arquivo services.yaml, que contém os links e ícones que aparecerão na tela. Usaremos como exemplo serviços de infraestrutura, mídia e projetos pessoais.

Passo 4: Limpeza de itens padrão

O Homepage traz alguns links de exemplo (como GitHub e Reddit) que podem poluir a interface. Para removê-los, criamos um arquivo de favoritos vazio:

Passo 5: Inicialização do painel

Com os arquivos criados, basta iniciar o contêiner. O parâmetro -d faz com que o programa rode em segundo plano.

Como acessar

Após a execução, o painel estará disponível através do navegador de qualquer computador ou celular conectado na mesma rede. Basta digitar o endereço IP do servidor seguido da porta escolhida. Exemplo:

http://192.168.2.14:3001

Conclusão

O uso de um dashboard como o Homepage transforma a experiência de gerenciar um servidor doméstico. Ele remove a necessidade de decorar portas lógicas e oferece uma visão geral sobre a saúde do hardware. A configuração via arquivos YAML permite que o administrador faça alterações rápidas e mantenha o controle total sobre a interface sem a necessidade de ferramentas complexas de edição gráfica.