Como instalar o Homepage na Saplo (painel de controlo inicial)

Quem instala mais do que uma aplicação na Box, mais cedo ou mais tarde perde a orientação de onde está o n8n, onde está o painel do Uptime Kuma e onde está o Grafana do cliente. A solução é ter uma única página inicial com uma lista de links, que abres em vez de procurar um separador no navegador. A Homepage faz exatamente isso, como um dashboard de código aberto que instalas na tua própria Box sem uma base de dados e sem uma fatura mensal. Abaixo, passo a passo, como instalar a Homepage no Saplo.

Porquê usar a Homepage em vez de marcadores no navegador

Os marcadores no navegador funcionam enquanto o número de aplicações é pequeno e as abres todas a partir de um único computador. O problema começa quando:

• o número de aplicações aumenta - uma agência com vários clientes e várias ferramentas internas (n8n, monitorização, painel CMS) rapidamente atinge uma dúzia de endereços que precisam de ser lembrados ou guardados.
• as ferramentas são utilizadas por mais do que uma pessoa - os marcadores num navegador privado não ajudam a equipa, cada um tem de receber uma lista de endereços separadamente, e quando um domínio muda, tem de ser enviado novamente.

Homepage resolve isto como um único container Docker no teu Box: uma página com links que dás a toda a gente na equipa, sem limite no número de aplicações e sem custos adicionais para além do custo do próprio Box.

Requisitos

Para instalares o Homepage na Saplo, precisas de:

• Uma Box com o Docker a funcionar (o motor ativa-o automaticamente ao instalar a partir do catálogo, é necessário o nesting no contentor, que a Saplo tem por predefinição),
• Um mínimo de 512 MB de RAM livre na Box e 2 GB de espaço em disco, ou seja, o plano Box S é suficiente (27 € por ano),
• Um domínio ou subdomínio *.saploapp.pl incluído em cada plano, onde o dashboard será alojado,
• NÃO precisas de uma base de dados separada, o Homepage armazena toda a configuração em ficheiros YAML no volume do Docker.

Instalação passo a passo

1. No painel da Saplo, vai a Catálogo de aplicações e escolhe Homepage (categoria "Negócios").
2. Indica uma Box com um mínimo de 512 MB de RAM livre, onde o dashboard será instalado, e o domínio ou subdomínio sob o qual irá funcionar.
3. Confirma a instalação. O motor cria um contentor a partir da imagem oficial ghcr.io/gethomepage/homepage, expõe-no exclusivamente ao loopback da Box e conecta-o ao nginx, que o serve sob o domínio especificado com SSL gratuito. Apenas a porta 443 é exposta externamente, não a porta 3000 do contentor.
4. Após docker compose up, o motor verifica adicionalmente se o dashboard responde de facto via HTTP no endpoint /api/healthcheck, pois o estado de "contentor a funcionar" não significa que o processo interno não tenha entrado num ciclo de reinícios pouco depois.
5. Após a conclusão da instalação, o painel Homepage está disponível sob o domínio especificado, protegido por uma palavra-passe gerada automaticamente durante a instalação (gravada no ficheiro SETUP na Box).

Primeira configuração

O Homepage não tem um assistente ou conta de administrador, apenas autenticação de palavra-passe única integrada, ativada imediatamente após a instalação.

1. Acede ao endereço de domínio, por exemplo, start.saploapp.pl, e inicia sessão com a palavra-passe do ficheiro HOMEPAGE-SETUP.txt na Box.
2. Podes adicionar os teus próprios links para aplicações manualmente no ficheiro services.yaml no volume de configuração; cada entrada é um nome, um endereço e um ícone opcional.
3. Os widgets de previsão do tempo, o estado dos contentores Docker ou as estatísticas de outras ferramentas são configurados em widgets.yaml, e os separadores para páginas externas em bookmarks.yaml.
4. O aspeto e o layout do dashboard (cores, número de colunas, fundo) são definidos em settings.yaml.
5. A integração com o socket Docker da Box está intencionalmente desativada no Saplo, portanto, o Homepage NÃO deteta automaticamente outros contentores. Deves adicionar cada aplicação manualmente; esta é a mesma restrição que em qualquer outra receita numa Box partilhada com outros clientes.

Homepage na Saplo versus separadores do navegador

Perguntas frequentes

O Homepage precisa de uma base de dados separada? Não, toda a configuração está nos ficheiros YAML no volume Docker, o motor Saplo não implementa nenhum contentor de base de dados adicional para isso.

O Homepage deteta automaticamente outras aplicações na Box? Não, a integração com o socket Docker do anfitrião é desativada propositadamente por motivos de segurança, uma vez que a Box é partilhada com outros clientes. Os links para as aplicações são adicionados manualmente no ficheiro services.yaml.

Como posso mudar a palavra-passe do dashboard? Edita a variável HOMEPAGE_AUTH_PASSWORD nas opções do contentor no painel Saplo e reinicia a aplicação. A palavra-passe predefinida é aleatória e está guardada no ficheiro HOMEPAGE-SETUP.txt na Box.

É preciso instalar o Docker antes de configurar o Homepage? Não, o motor Saplo instala o Docker CE automaticamente na primeira instalação de qualquer aplicação em contentor numa Box específica.

Se tens várias aplicações na tua Box e queres um único ponto de partida para todas, em vez de procurares separadores, fala connosco. Ajudamos-te a escolher a Box ideal para o teu conjunto de ferramentas.