Come installare Homepage su Saplo (dashboard di avvio)

Chi installa più di un'applicazione su un Box, prima o poi perde l'orientamento: non ricorda più a quale indirizzo si trova n8n, o dove si trova il pannello di Uptime Kuma, o quello di Grafana del cliente. La soluzione è una singola pagina iniziale con un elenco di link, che apri invece di cercare la scheda nel browser. Homepage fa esattamente questo, come dashboard open source che installi sul tuo Box, senza database e senza costi mensili. Di seguito, passo dopo passo, ti spieghiamo come installare Homepage su Saplo.

Perché usare Homepage anziché i preferiti del browser

I preferiti del browser funzionano finché il numero di applicazioni è esiguo e le apri tutte da un unico computer. Il problema inizia quando:

• il numero di applicazioni aumenta - un'agenzia con diversi clienti e più strumenti interni (n8n, monitoraggio, pannello CMS) raggiunge rapidamente una dozzina di indirizzi che devono essere ricordati o salvati,
• più di una persona utilizza gli strumenti - i preferiti nel browser privato non aiuteranno il team, ognuno deve ricevere un elenco di indirizzi separatamente, e quando il dominio cambia, deve essere inviato di nuovo.

Homepage risolve questo problema come un singolo container Docker sul tuo Box: un'unica pagina con link che fornisci a tutti i membri del team, senza limiti al numero di applicazioni e senza alcun costo oltre al costo del Box stesso.

Requisiti

Per creare la tua Homepage su Saplo, hai bisogno di:

• Un Box con Docker attivo (il motore lo abilita automaticamente durante l'installazione dal catalogo, è richiesto il nesting nel container, che Saplo ha di default),
• Almeno 512 MB di RAM liberi sul Box e 2 GB di spazio su disco, il che significa che è sufficiente il piano Box S,
• Un dominio o un sottodominio *.saploapp.pl incluso nel prezzo di ogni piano, dove sarà ospitato il dashboard,
• NON hai bisogno di un database separato, la Homepage memorizza tutta la configurazione nei file YAML nel volume Docker.

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Homepage (categoria "Business").
2. Indica il Box con un minimo di 512 MB di RAM libera dove installerai la dashboard, e il Dominio o sottodominio sotto il quale funzionerà.
3. Conferma l'installazione. Il motore creerà un container dall'immagine ufficiale ghcr.io/gethomepage/homepage, lo esporrà solo sul loopback del Box e lo connetterà a Nginx, che lo servirà sotto il Dominio specificato con un SSL gratuito. Verso l'esterno è esposta solo la porta 443, non la porta raw 3000 del container.
4. Dopo docker compose up, il motore verifica inoltre se la dashboard risponde effettivamente via HTTP sull'endpoint /api/healthcheck, poiché lo Stato "il container è in funzione" non significa che il processo interno non sia entrato in un ciclo di riavvii poco dopo.
5. Al termine dell'installazione, il pannello Homepage è disponibile sotto il Dominio specificato, protetto da una password generata automaticamente durante l'installazione (salvata nel file SETUP sul Box).

Prima configurazione

Homepage non ha una procedura guidata né un account amministratore, ma solo un'autorizzazione integrata con una password, abilitata immediatamente all'installazione.

1. Vai all'indirizzo del dominio, ad esempio start.saploapp.pl, e accedi con la password del file HOMEPAGE-SETUP.txt sul Box.
2. Aggiungi manualmente i tuoi link alle applicazioni nel file services.yaml nel volume di configurazione; ogni voce è un nome, un indirizzo e un'icona opzionale.
3. Configuri i widget meteo, lo stato dei container Docker o le statistiche di altri strumenti in widgets.yaml, e le schede per i siti esterni in bookmarks.yaml.
4. Imposti l'aspetto e il layout della dashboard (colori, numero di colonne, sfondo) in settings.yaml.
5. L'integrazione con il socket Docker del Box è intenzionalmente disabilitata in Saplo, quindi Homepage NON rileva automaticamente altri container; ogni applicazione va aggiunta manualmente. Questa è la stessa limitazione di qualsiasi altra ricetta su un Box condiviso con altri clienti.

Homepage su Saplo vs. segnalibri del browser

Domande frequenti

Homepage richiede un database separato? No, l'intera configurazione si trova nei file YAML nel volume Docker, il motore Saplo non crea alcun container database aggiuntivo.

Homepage rileva automaticamente altre applicazioni sul Box? No, l'integrazione con il socket Docker dell'host è intenzionalmente disabilitata per motivi di sicurezza del Box, condiviso con altri clienti; i link alle applicazioni devono essere aggiunti manualmente nel file services.yaml.

Come si cambia la password della dashboard? Puoi modificare la variabile HOMEPAGE_AUTH_PASSWORD nelle opzioni del container nel pannello Saplo e riavviare l'applicazione. La password predefinita è casuale e salvata nel file HOMEPAGE-SETUP.txt sul Box.

È necessario installare Docker manualmente prima di configurare Homepage? No, il motore Saplo installa Docker CE automaticamente alla prima installazione di qualsiasi applicazione containerizzata su un dato Box.

Se hai diverse applicazioni sul tuo Box e desideri un unico punto di accesso anziché cercare tra le schede, scrivici. Ti aiuteremo a scegliere il Box più adatto alle tue esigenze.