Dashboard self-hosted Homepage cu tile-uri de servicii, status containere si widget-uri de resurse
Self-hosting

Dashboard Homepage cu Docker: o pagina de start pentru server

Cand ajungi sa rulezi mai mult de cateva aplicatii pe un VPS, apare o problema discreta: uiti unde e fiecare. Uptime Kuma era pe portul 3001 sau pe status.domeniul-tau? Aplicatia de sincronizare a fisierelor chiar ruleaza, sau a cazut dupa update-ul de azi-noapte? Ajungi cu un folder de bookmark-uri plin de adrese IP pe jumatate uitate si cu un terminal deschis permanent pe docker ps. Un dashboard self-hosted rezolva asta cu o singura pagina care leaga toate aplicatiile, arata daca fiecare container e pornit si aduce date live direct din servicii. In ghidul de azi construim exact asta cu Homepage, pas cu pas, pe un VPS proaspat.

Homepage este un proiect open source (licenta GPL-3.0), documentat pe gethomepage.dev , cu codul pe github.com/gethomepage/homepage . E o pagina de start rapida, construita in Next.js, se integreaza cu peste o suta de aplicatii self-hosted populare si, partea care ne place cel mai mult, toata configuratia sta in cateva fisiere YAML simple. Fara baza de date, fara panou de administrare prin care sa dai click, nimic ascuns: daca stii sa editezi un fisier text, iti poti construi dashboard-ul.

Ce este Homepage si de ce ajuta un dashboard

Gandeste-te la Homepage ca la pagina de “tab nou” a serverului tau. Fiecare aplicatie devine un tile (o casuta), tile-urile sunt aranjate in grupuri (de exemplu “Infrastructura” si “Aplicatii”), iar pagina se incarca intr-o fractiune de secunda. Are trei tipuri de elemente:

  • Servicii: tile-uri pentru aplicatiile tale. Fiecare are un link, o iconita, o descriere scurta si, optional, un indicator de status si un widget care afiseaza date live din API-ul aplicatiei, de exemplu cate monitoare sunt sus in Uptime Kuma.
  • Widget-uri de informatii: bara din partea de sus a paginii, cu utilizarea de CPU, RAM si disc, data si ora, vremea sau o casuta de cautare.
  • Bookmark-uri: liste simple de linkuri pentru lucruri pe care le folosesti des, dar nu le gazduiesti tu, cum ar fi furnizorul de DNS, contul de client la hosting sau documentatia.

Homepage vorbeste si cu Docker. Daca esti nou in domeniu, Docker este instrumentul care ruleaza aplicatii in containere: medii izolate, impachetate, care contin o aplicatie si tot ce ii trebuie, astfel incat sa se comporte la fel pe orice server. Pentru ca Homepage poate intreba Docker ce containere exista si in ce stare sunt, fiecare tile poate afisa o mica eticheta “running” sau “exited”, iar label-urile Docker pot chiar sa creeze tile-uri automat.

Formatul de configurare este YAML, un format text usor de citit, in care structura e data de indentare (spatiile de la inceputul randului). E singurul “limbaj” de care ai nevoie in acest tutorial si explicam fiecare fisier pe care il atingem.

Ce construim

La finalul ghidului vei avea:

  • Homepage rulat cu Docker Compose, accesibil doar prin HTTPS la o adresa de tipul https://dash.exemplu.ro, protejat cu parola.
  • O lista cu serviciile tale, pe grupuri, cu iconite, descrieri si verificari de disponibilitate.
  • Status live al containerelor printr-un proxy read-only pentru socket-ul Docker (explicam mai jos de ce nu ii dam lui Homepage socket-ul direct).
  • O bara de sus cu resursele serverului, data si ora, vremea si cautare.
  • Un singur folder config care contine tot si care se salveaza prin simpla copiere.

Homepage comparat cu alte dashboard-uri

Homepage nu e singura pagina de start existenta. Homer e o pagina statica, cu consum aproape zero, dar fara status live. Heimdall si Dashy te lasa sa editezi tile-urile din browser. Homarr ofera o interfata drag-and-drop, dar e vizibil mai greu. Homepage sta intr-un punct de echilibru bun: consum moderat de memorie, integrari bogate si configuratie in fisiere text pe care le poti tine in Git.

RAM aproximativ in repaus, dashboard-uri self-hostedHomer~10 MBHeimdall~90 MBHomepage~120 MBDashy~180 MBHomarr~350 MB0100200300400RAM in repaus, in MB (aproximativ, un singur utilizator)Dashboard
Consum aproximativ de memorie in repaus, masurat pe un VPS mic. Valorile reale depind de numarul de widget-uri si de cat de des se reimprospateaza.

Impreuna cu proxy-ul pentru socket (cativa MB), Homepage ramane confortabil sub 150 MB de RAM, deci incape langa celelalte aplicatii chiar si pe cel mai mic VPS.

De ce ai nevoie

  • Un VPS DreamServer cu Debian 13 sau Ubuntu 24.04. 1 vCPU si 1 GB RAM sunt mai mult decat suficiente pentru Homepage.
  • Acces SSH cu un utilizator sudo (un utilizator obisnuit care are voie sa ruleze comenzi administrative cu sudo).
  • Un domeniu sau subdomeniu pe care il controlezi, de exemplu dash.exemplu.ro, cu o inregistrare DNS de tip A catre IP-ul VPS-ului. Inregistrarea A este pur si simplu intrarea care spune internetului “numele asta locuieste la IP-ul asta”.
  • Aproximativ 30 de minute si un editor de text in terminal (folosim nano, care e preinstalat).
  • Optional, dar mai interesant: cateva aplicatii care ruleaza deja pe server, ca dashboard-ul sa aiba ce afisa.

O nota pentru clientii cu LXC: Docker ruleaza intr-un container LXC unprivileged doar daca functia “nesting” este activata. Daca Docker refuza sa porneasca, contacteaza suportul ca sa o activeze, sau foloseste un VPS KVM, unde Docker merge fara setari speciale.

Cum se leaga piesele intre ele

Inainte sa scriem comenzi, hai sa vedem drumul pe care il face o cerere. Odata ce intelegi asta, alegerile de securitate de mai tarziu devin evidente.

Cum ajunge o cerere la HomepageVPS-ul tau DreamServerBrowsertu, de oriundeFirewall UFW80, 443 deschiseCaddyHTTPS + parolaTLS Let's EncryptHomepage127.0.0.1:3000Socket proxyAPI read-onlyAplicatiile taleapeluri API widget./configfisiere YAMLPortul 3000 nu este niciodata expus in internet
Doar Caddy este expus in internet. Homepage asculta pe localhost, citeste starea Docker printr-un proxy read-only si setarile din folderul config.

Ce face fiecare piesa:

  • Firewall-ul (UFW) decide ce porturi de retea sunt accesibile din exterior. Un port este o usa numerotata a serverului: SSH foloseste 22, traficul web foloseste 80 (HTTP) si 443 (HTTPS). Deschidem doar aceste trei.
  • Caddy este un reverse proxy: un server web care primeste fiecare vizitator, se ocupa automat de certificatul HTTPS prin Let’s Encrypt, cere o parola si apoi trimite cererea mai departe catre aplicatia potrivita din interior.
  • Homepage asculta pe portul 3000, dar doar pe 127.0.0.1 (localhost), adica nimeni din internet nu il poate accesa direct. Doar Caddy, care ruleaza pe aceeasi masina, poate.
  • Socket proxy-ul este un container minuscul care sta intre Homepage si Docker si permite doar intrebari sigure, read-only, de tipul “ce containere ruleaza?”.
  • Folderul config contine fisierele YAML care descriu dashboard-ul. Sta pe discul VPS-ului, deci supravietuieste repornirilor si update-urilor containerului.

Toata procedura dintr-o privire

Instalarea Homepage in 8 pasi1Pregatire VPSDocker, firewall2Fisier composefolder + YAML3Prima pornirecompose up -d4settings.yamltema, layout5services.yamlservicii, linkuri6Status livesocket proxy7Widget-uriinfo, bookmark-uri8HTTPS + parolaproxy Caddy
Pasii 1-3 pornesc Homepage, pasii 4-7 construiesc dashboard-ul, iar pasul 8 il publica in siguranta prin HTTPS.

Pasul 1: Pregatim VPS-ul (update-uri, Docker, firewall)

Mai intai aducem sistemul la zi. Asa instalam patch-urile de securitate inainte sa adaugam ceva nou:

sudo apt update && sudo apt upgrade -y

Pe Ubuntu, verifica daca e nevoie de restart (de exemplu dupa un update de kernel):

[ -f /var/run/reboot-required ] && echo "Reboot needed" || echo "No reboot needed"

Debian nu creeaza implicit fisierul /var/run/reboot-required, asa ca daca upgrade-ul a instalat un pachet nou linux-image, fa pur si simplu sudo reboot ca sa fii sigur.

Apoi instalam Docker din repository-ul oficial Docker. Pachetele din distributie sunt adesea mai vechi si nu includ plugin-ul Compose v2 sub acelasi nume. Blocul de mai jos merge si pe Debian, si pe Ubuntu, pentru ca citeste numele distributiei (ID) si numele de cod al versiunii din /etc/os-release:

sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/${ID}/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verificam ca functioneaza:

sudo docker run --rm hello-world
sudo docker compose version

Ar trebui sa vezi mesajul “Hello from Docker!”, urmat de ceva de genul Docker Compose version v2.x.x. In acest ghid punem mereu sudo in fata comenzilor Docker. Iti poti adauga utilizatorul in grupul docker ca sa scapi de el, dar tine minte ca apartenenta la acest grup este practic echivalenta cu acces root.

Acum firewall-ul. Pe Debian 13, UFW nu este instalat implicit; pe Ubuntu 24.04 este instalat, dar inactiv. Aceleasi comenzi merg pe ambele:

sudo apt install -y ufw
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

Daca serverul SSH asculta pe alt port, permite acel port inainte de ufw enable, altfel iti tai singur accesul. Un detaliu important: porturile publicate de Docker ocolesc regulile UFW, pentru ca Docker isi scrie propriile reguli de firewall. De aceea, la pasul urmator publicam Homepage doar pe 127.0.0.1, in loc sa ne bazam pe UFW ca sa il ascunda.

Pasul 2: Cream folderul proiectului si fisierul Compose

Docker Compose ne permite sa descriem mai multe containere, setarile lor si felul in care comunica, intr-un singur fisier numit compose.yaml. Cream un folder pentru proiect, cu un subfolder config pentru setarile Homepage:

mkdir -p ~/homepage/config
cd ~/homepage
id -u && id -g

Ultima comanda afiseaza ID-ul utilizatorului si al grupului tau, de obicei 1000 si 1000 pe un VPS nou. Homepage isi va crea fisierele cu aceste ID-uri, ca sa le poti edita fara sudo. Acum cream fisierul Compose:

nano compose.yaml

Lipeste continutul de mai jos, inlocuind dash.exemplu.ro cu subdomeniul tau real si 1000 cu valorile pe care tocmai le-ai vazut:

services:
  dockerproxy:
    image: tecnativa/docker-socket-proxy:latest
    container_name: dockerproxy
    environment:
      CONTAINERS: "1"   # permite citirea listei de containere si a statisticilor
      POST: "0"         # blocheaza orice operatie de scriere (start, stop, stergere)
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped
    networks:
      - homepage

  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    environment:
      HOMEPAGE_ALLOWED_HOSTS: "dash.exemplu.ro"
      PUID: "1000"
      PGID: "1000"
    ports:
      - "127.0.0.1:3000:3000"
    volumes:
      - ./config:/app/config
    depends_on:
      - dockerproxy
    restart: unless-stopped
    networks:
      - homepage

networks:
  homepage:
    name: homepage

Salveaza cu Ctrl+O, Enter, si iesi cu Ctrl+X. Ce inseamna fiecare parte:

  • dockerproxy se conecteaza la socket-ul Docker (/var/run/docker.sock, “canalul de comanda” al Docker) si expune catre celelalte containere din reteaua privata homepage doar endpoint-urile de citire pentru containere. Portul lui, 2375, nu este publicat niciodata pe host.
  • HOMEPAGE_ALLOWED_HOSTS este o verificare de securitate introdusa in Homepage v1: aplicatia raspunde doar cererilor adresate numelor de host din aceasta lista. localhost:3000 si 127.0.0.1:3000 sunt mereu permise, ceea ce e util la teste.
  • ports "127.0.0.1:3000:3000" inseamna “publica portul 3000 al containerului pe host, dar doar pe localhost”.
  • volumes ./config:/app/config este un bind mount: folderul config de pe VPS apare in container la /app/config, deci fisierele YAML raman in afara containerului.
  • restart: unless-stopped reporneste containerele dupa un reboot sau o cadere.

Despre tag-urile de imagine: :latest descarca mereu cea mai noua versiune, ceea ce e comod, dar inseamna ca un update te poate surprinde. Pentru un setup pe care il atingi rar, fixeaza o versiune anume de pe pagina de release-uri Homepage , cu un tag de forma vX.Y.Z, si schimba-l constient cand vrei sa faci upgrade. Proxy-ul pentru socket se schimba rar, deci :latest e un compromis rezonabil acolo, dar il poti fixa la fel.

Pasul 3: Pornim Homepage pentru prima data

Pornim ambele containere in fundal (-d inseamna “detached”):

sudo docker compose up -d
sudo docker compose ps

In rezultatul lui ps ar trebui sa apara dockerproxy si homepage cu statusul Up. Uita-te in loguri ca sa confirmi ca Homepage a pornit curat:

sudo docker compose logs --tail 30 homepage

Ar trebui sa vezi un rand care spune ca serverul e gata pe portul 3000. Acum cerem o pagina chiar de pe VPS:

curl -sI http://127.0.0.1:3000 | head -n 1

Rezultat asteptat: HTTP/1.1 200 OK. La prima pornire, Homepage copiaza si fisiere de exemplu in folderul config, care era gol:

ls config

Ar trebui sa vezi fisiere precum bookmarks.yaml, docker.yaml, services.yaml, settings.yaml, widgets.yaml, plus custom.css si custom.js pentru stilizare avansata. De acum incolo, doar pe acestea le vei edita.

Ca sa vezi dashboard-ul in browser inainte sa configuram HTTPS, folosim un tunel SSH, care redirectioneaza un port de pe calculatorul tau catre VPS prin conexiunea SSH criptata. Pe calculatorul tau (nu pe VPS), ruleaza:

ssh -L 3000:127.0.0.1:3000 utilizatorul-tau@ip-ul-vps-ului

Cat timp sesiunea ramane deschisa, deschide in browser http://localhost:3000. Vei vedea Homepage cu continutul de exemplu. Lasa tunelul deschis, pentru ca vom da refresh la pagina dupa fiecare pas urmator.

Pasul 4: Setam aspectul si layout-ul in settings.yaml

settings.yaml controleaza aspectul general: titlul paginii, tema, culorile si felul in care sunt asezate grupurile. Deschide-l:

nano ~/homepage/config/settings.yaml

Inlocuieste continutul cu:

title: Serverul meu
theme: dark
color: slate
headerStyle: boxed
statusStyle: dot
hideVersion: true
layout:
  Infrastructura:
    style: row
    columns: 3
  Aplicatii:
    style: row
    columns: 3

theme poate fi dark sau light, color alege paleta (de exemplu slate, zinc, blue, emerald), statusStyle: dot afiseaza disponibilitatea ca un punct colorat in loc de o eticheta text, iar sectiunea layout ii spune lui Homepage sa afiseze grupurile “Infrastructura” si “Aplicatii” pe randuri, cate trei tile-uri. Numele grupurilor trebuie sa fie exact cele pe care le folosesti in services.yaml la pasul urmator, inclusiv literele mari.

Da refresh in browser: majoritatea modificarilor apar imediat. Daca ceva nu se actualizeaza, reporneste containerul cu sudo docker compose restart homepage.

Tine minte regula de aur a YAML: indentarea se face cu spatii, niciodata cu tab-uri, iar fiecare nivel este indentat consecvent (doua spatii in exemplele noastre).

Pasul 5: Adaugam serviciile in services.yaml

Acum, inima dashboard-ului. Deschide services.yaml:

nano ~/homepage/config/services.yaml

Iata un exemplu cu doua grupuri. Adapteaza numele si adresele la aplicatiile pe care chiar le rulezi:

- Infrastructura:
    - Uptime Kuma:
        icon: uptime-kuma.png
        href: https://status.exemplu.ro
        description: Monitorizare uptime si status page
        siteMonitor: https://status.exemplu.ro
        widget:
          type: uptimekuma
          url: https://status.exemplu.ro
          slug: main

    - Webmail:
        icon: mdi-email-outline
        href: https://mail.exemplu.ro
        description: Casutele de email ale firmei
        siteMonitor: https://mail.exemplu.ro

- Aplicatii:
    - Nextcloud:
        icon: nextcloud.png
        href: https://cloud.exemplu.ro
        description: Fisiere, calendar si contacte
        siteMonitor: https://cloud.exemplu.ro

    - Site:
        icon: mdi-web
        href: https://www.exemplu.ro
        description: Site-ul public al firmei
        siteMonitor: https://www.exemplu.ro

Structura este: o lista de grupuri, fiecare grup contine o lista de servicii, fiecare serviciu are setarile lui. Campurile:

  • icon: numele unei iconite. Numele terminate in .png vin din biblioteca de iconite integrata in Homepage pentru aplicatii populare; numele care incep cu mdi- folosesc iconite Material Design, utile pentru lucruri generice.
  • href: unde te duce tile-ul cand dai click.
  • siteMonitor: Homepage trimite periodic o cerere catre acest URL si afiseaza un punct verde sau rosu plus timpul de raspuns. Merge pentru orice adresa web, chiar si de pe alte servere.
  • widget: date live din API-ul aplicatiei. Widget-ul uptimekuma are nevoie de URL-ul instantei Uptime Kuma si de slug-ul uneia dintre paginile ei de status (ultima parte din URL-ul paginii de status), apoi arata cate monitoare sunt sus sau jos.

Widget-urile sunt interogate de serverul Homepage, nu de browserul tau, deci cheile API ale aplicatiilor care au nevoie de ele raman pe VPS. Daca o aplicatie ruleaza in Docker pe acelasi server, poti conecta containerul ei la reteaua homepage (declarata cu external: true in fisierul Compose al aplicatiei) si poti folosi adresa interna, de exemplu http://uptime-kuma:3001, in loc de URL-ul public.

Salveaza si da refresh. Tile-urile ar trebui sa apara in doua grupuri, cu puncte verzi pentru site-urile care raspund.

Pasul 6: Afisam statusul live al containerelor cu docker.yaml

Pana acum Homepage verifica URL-uri. Acum il lasam sa vada chiar containerele, prin proxy-ul read-only pornit la Pasul 2. Deschide docker.yaml:

nano ~/homepage/config/docker.yaml

Inlocuieste continutul cu:

my-docker:
  host: dockerproxy
  port: 2375

my-docker este doar un nume ales de noi pentru acest server Docker, iar dockerproxy este numele containerului proxy, pe care Docker il rezolva automat in reteaua comuna homepage. Acum legam un tile de un container, adaugand doua randuri la serviciul din services.yaml:

    - Uptime Kuma:
        icon: uptime-kuma.png
        href: https://status.exemplu.ro
        description: Monitorizare uptime si status page
        server: my-docker
        container: uptime-kuma

container trebuie sa fie identic cu numele din coloana NAMES a comenzii sudo docker ps. Dupa un restart (sudo docker compose restart homepage), tile-ul afiseaza starea containerului, iar un click pe status arata consumul de CPU si memorie al acelui container. Daca vrei aceste cifre pe fiecare tile tot timpul, adauga showStats: true in settings.yaml.

Exista si o varianta si mai comoda: label-urile Docker. Label-urile sunt mici etichete cheie/valoare atasate unui container. Daca adaugi label-uri Homepage in fisierul Compose al altei aplicatii, Homepage o descopera automat prin proxy, fara sa mai editezi services.yaml:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    labels:
      - homepage.group=Infrastructura
      - homepage.name=Uptime Kuma
      - homepage.icon=uptime-kuma.png
      - homepage.href=https://status.exemplu.ro
      - homepage.description=Monitorizare uptime

Alege o singura metoda pentru fiecare serviciu: daca definesti aceeasi aplicatie si in services.yaml, si prin label-uri, va aparea de doua ori.

Pasul 7: Adaugam widget-uri de informatii si bookmark-uri

Bara de informatii de sus se configureaza in widgets.yaml:

nano ~/homepage/config/widgets.yaml
- resources:
    cpu: true
    memory: true
    disk: /

- datetime:
    text_size: xl
    format:
      timeStyle: short
      dateStyle: short

- openmeteo:
    label: Bucuresti
    latitude: 44.43
    longitude: 26.10
    timezone: Europe/Bucharest
    units: metric

- search:
    provider: duckduckgo
    target: _blank

resources arata utilizarea de CPU, RAM si disc. Intr-un container Docker pe un VPS KVM, valorile reflecta intregul server, iar disk: / raporteaza sistemul de fisiere pe care stau datele Docker, de obicei discul principal. Pe un VPS LXC vezi limitele containerului tau. openmeteo foloseste un serviciu meteo gratuit care nu cere cheie API, iar search adauga o casuta de cautare care deschide rezultatele intr-un tab nou.

Bookmark-urile se pun in bookmarks.yaml:

nano ~/homepage/config/bookmarks.yaml
- Administrare:
    - DreamServer:
        - abbr: DS
          href: https://dreamserver.ro
    - Documentatie Docker:
        - abbr: DK
          href: https://docs.docker.com

- Documentatie:
    - Documentatie Homepage:
        - abbr: HP
          href: https://gethomepage.dev

Formatul pare putin ciudat la inceput: fiecare bookmark este o lista cu un singur element, care contine setarile lui. abbr este o abreviere de doua litere afisata cand nu exista iconita. Da refresh si dashboard-ul e complet. Un bonus dragut: incepe pur si simplu sa tastezi pe pagina si functia quick launch din Homepage cauta prin servicii, deci deschizi orice aplicatie din cateva taste.

Pasul 8: Il publicam cu HTTPS si parola

Homepage nu are login propriu. Oricine ajunge la el vede toate serviciile, iar widget-urile pot dezvalui detalii interne. Asa ca il punem in spatele lui Caddy, care adauga HTTPS si parola in cateva randuri.

Mai intai, asigura-te ca subdomeniul indica spre VPS:

getent hosts dash.exemplu.ro

Rezultatul trebuie sa contina IP-ul VPS-ului. Daca nu, corecteaza inregistrarea DNS de tip A si asteapta cateva minute. Apoi instaleaza Caddy, disponibil in repository-urile oficiale atat pe Debian 13, cat si pe Ubuntu 24.04 (pe Ubuntu vine din componenta universe, activata implicit pe imaginile de server):

sudo apt install -y caddy
caddy hash-password

caddy hash-password iti cere parola de doua ori si afiseaza un hash care incepe cu $2a$14$. Un hash este o versiune amestecata, ireversibila, a parolei, deci parola reala nu ajunge niciodata intr-un fisier de configurare. Copiaza-l, apoi editeaza configuratia Caddy:

sudo nano /etc/caddy/Caddyfile

Inlocuieste tot fisierul cu:

dash.exemplu.ro {
	basicauth {
		admin $2a$14$LIPESTE_AICI_HASH_UL_TAU
	}
	reverse_proxy 127.0.0.1:3000
}

admin este numele de utilizator pe care il vei introduce in browser. Folosim directiva basicauth pentru ca merge pe versiunea de Caddy livrata de ambele distributii; versiunile mai noi de Caddy o numesc basic_auth si accepta in continuare vechiul nume, cu un avertisment. Validam si reincarcam:

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -sI https://dash.exemplu.ro | head -n 1

Rezultat asteptat: HTTP/2 401. Acel “401 Unauthorized” e o veste buna: inseamna ca HTTPS functioneaza, certificatul a fost emis si se cere parola. Deschide https://dash.exemplu.ro in browser, autentifica-te si bucura-te de dashboard. Acum poti inchide tunelul SSH de la Pasul 3.

Probleme frecvente si greseli comune

  • “Host validation failed” in browser: adresa folosita nu este in HOMEPAGE_ALLOWED_HOSTS. Adaug-o (mai multe host-uri se separa prin virgula, fara spatii) si ruleaza sudo docker compose up -d ca sa aplici schimbarea. Valoarea * dezactiveaza verificarea, ceea ce nu recomandam.
  • Pagina de eroare dupa ce ai editat YAML: aproape mereu e vorba de indentare, un caracter tab sau doua puncte lipsa. Ruleaza sudo docker compose logs --tail 50 homepage; logul iti spune fisierul si randul. La nevoie, revino la ultima varianta functionala.
  • Statusul containerului apare “not found” sau “unknown”: valoarea container nu se potriveste cu docker ps, valoarea server nu se potriveste cu numele din docker.yaml sau proxy-ul nu ruleaza. Verifica cu sudo docker compose ps.
  • Un widget afiseaza “API Error”: URL gresit, slug sau cheie gresite, sau Homepage nu poate ajunge la adresa din interiorul containerului. Incearca mai intai URL-ul public HTTPS, apoi treci la adrese interne dupa ce merge.
  • Caddy nu poate obtine certificatul: portul 80 sau 443 e blocat, inregistrarea DNS indica in alta parte sau alt server web (Apache, nginx) foloseste deja acele porturi. Citeste sudo journalctl -u caddy --no-pager -n 50.
  • Permission denied cand editezi fisierele de config: valorile PUID/PGID nu corespund utilizatorului tau. Corecteaza-le in compose.yaml si ruleaza sudo chown -R $USER:$USER ~/homepage/config.
  • Portul 3000 e deja folosit: il ocupa alta aplicatie. Schimba doar partea din stanga, de exemplu "127.0.0.1:3010:3000", si indreapta Caddy catre 127.0.0.1:3010.
  • Docker nu porneste pe un VPS LXC: nesting-ul e dezactivat pentru containerul tau. Cere suportului sa il activeze sau foloseste un VPS KVM.

Note de securitate

  • Nu sari niciodata peste parola. Homepage e gandit ca pagina de start privata. Pe langa basic auth in Caddy, un VPN este o optiune si mai solida daca doar tu si echipa ta folositi dashboard-ul.
  • Socket-ul Docker inseamna acces root. Cine poate vorbi liber cu el poate porni un container privilegiat si poate prelua serverul. Montarea cu :ro nu schimba asta, de aceea folosim proxy-ul cu POST=0 si nu ii publicam niciodata portul.
  • Tine Homepage pe localhost. Pentru ca Docker ocoleste UFW, o mapare de tipul "3000:3000" ar expune dashboard-ul in internet fara HTTPS si fara parola. Pastreaza mereu prefixul 127.0.0.1:.
  • Tine secretele in afara fisierelor YAML. Widget-urile care au nevoie de chei API le pot citi din variabile de mediu ale caror nume incep cu HOMEPAGE_VAR_. Pune-le intr-un fisier .env langa compose.yaml, protejeaza-l cu chmod 600 .env, adauga env_file: .env la serviciul homepage si foloseste valoarea in YAML asa:
        widget:
          type: portainer
          url: https://portainer.exemplu.ro
          env: 1
          key: "{{HOMEPAGE_VAR_PORTAINER_KEY}}"
  • Foloseste chei API read-only acolo unde aplicatiile ofera asa ceva: un dashboard are nevoie doar sa citeasca.

Cum tii Homepage la zi si cum faci backup

Update-ul inseamna doua comenzi, rulate din ~/homepage:

sudo docker compose pull
sudo docker compose up -d

Daca ai fixat o versiune, schimba mai intai tag-ul in compose.yaml. Citeste notele de release inainte de upgrade-urile mari, pentru ca optiunile de configurare se mai schimba din cand in cand. Cat despre backup, tot ce conteaza e in folderul proiectului:

tar czf ~/homepage-backup-$(date +%F).tar.gz -C ~ homepage

Copiaza arhiva si in afara serverului din cand in cand. Pentru ca toata configuratia e text simplu, se potriveste perfect si intr-un repository Git privat, astfel incat fiecare schimbare a dashboard-ului sa fie versionata.

Deci, merita Homepage?

Daca rulezi mai mult de trei-patru servicii, da. In jumatate de ora obtii o pagina care raspunde dintr-o privire la intrebarile “unde era aplicatia aia?” si “merge?”, cu date live din aplicatiile tale, si o configuratie formata din cateva fisiere text lizibile pe care le poti salva, versiona si copia pe urmatorul server. Te costa in jur de 120 MB de RAM si niciun efort continuu, in afara de cate un update.

Poti pune in practica tot ce e in acest ghid pe un VPS din data center-ul nostru din Romania, in cateva minute. Daca preferi ca altcineva sa iti configureze Docker, reverse proxy-ul, HTTPS-ul si dashboard-ul, echipa noastra de administrare servere poate construi si intretine tot stack-ul pentru tine.

Intrebari frecvente

Homepage are login sau conturi de utilizator?

Nu. Homepage nu are autentificare integrata, din design. Protejeaza-l cu un reverse proxy care cere parola, ca la Pasul 8, sau fa-l accesibil doar printr-un VPN.

Pot edita dashboard-ul din browser?

Nu, Homepage se configureaza doar prin fisiere YAML. E o alegere intentionata: fisierele text sunt usor de salvat, de comparat si de tinut in Git. Majoritatea modificarilor apar dupa un simplu refresh in browser.

Poate Homepage sa afiseze servicii de pe alte servere?

Da. siteMonitor merge cu orice URL, iar docker.yaml poate contine mai multe host-uri Docker, fiecare cu propriul socket proxy. Expune un proxy de pe alt server doar printr-o retea privata sau VPN, niciodata direct in internet.

Merge pe cel mai mic VPS?

Da. Homepage si socket proxy-ul consuma impreuna aproximativ 120-150 MB de RAM si aproape deloc CPU in repaus, lasand loc pentru aplicatiile catre care trimite dashboard-ul.

Functioneaza intr-un container LXC?

Da, atata timp cat Docker functioneaza, iar intr-un container LXC unprivileged asta cere activarea nesting-ului. Pe un VPS KVM nu exista astfel de restrictii.

Avem Incredere & Suntem Membri

Suntem membri ai principalelor organizatii de infrastructura internet.

RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX