Homepage: Open Source alternative to Notion in 2026
Homepage is a customizable start page for your HomeLab: it groups links and live-status widgets for all your self-hosted services on a single screen, configured through YAML files.
Audit Snapshot
View notes βLicense β Matches GitHub
GitHub β Active
Latest release β v2.5.0 Β· 4 days ago
Docker Compose β Not verified
Production β Not production-tested by AltFreeStack
Homepage vs. Notion
Pros
- Very quick to set up as your browser's start page
- Huge and active integrations catalog
Things to consider
- Configuration is YAML-based, no visual editor
Quick Docker installation guide
Copy this docker-compose.yml, adjust the example passwords and run docker compose up -d on your server. See the full step-by-step guide β
π‘ Official SaaS or self-hosted with AltFreeStack?
- On the official cloud: $10/mo per user on Notion.
- On your own VPS: 100% free software on your own server, with no artificial row, project or user limits.
services:
homepage:
image: ghcr.io/gethomepage/homepage:latest
ports:
- "3000:3000"
volumes:
- ./config:/app/config
- /var/run/docker.sock:/var/run/docker.sock:ro # opcional, para detectar contenedores automΓ‘ticamente
restart: unless-stopped
π Deploy in 1 command
Recommended for beginnersCopy this single command and paste it into your freshly created VPS's console (Vultr, DigitalOcean...). It downloads the script, prints it to your screen so you can see exactly what it's about to do (never a blind direct pipe), and only then installs Docker if needed, writes the files with secrets already generated, and starts everything β no nano, no pasting code blocks.
curl -sSL ".../api/deploy?stack=homepage" -o deploy.sh && cat deploy.sh && bash deploy.shThis docker-compose corresponds to an actively maintained project β last commit today.
This docker-compose not working for you? Report it on GitHub βTechnical profile
- License
- GPL-3.0
- Category
- Dev Tools
- Replaces
- Notion
- Tech stack
- TypeScriptNext.js
Under the hood
Database
None / File-based
Language
TypeScript (Next.js)
Platforms
Web
Key features
- 100+ integrations with live status widgets
- Automatically detects Docker containers
- Fully configurable via YAML, no database
πΎ Backups in 3 steps (Day 2)
As long as the ./data folder (the "volume" mapped into the container) exists on your server, your data survives any restart or container update β that's the only thing you need to back up.
1. Create a compressed backup on the server
tar -czvf backup-$(date +%F).tar.gz ./data2. Download it to your computer
From your computer's terminal (not your server's):
scp root@YOUR_IP:~/app/backup-*.tar.gz ./3. Restore in case of emergency
tar -xzvf backup-file.tar.gzπ Connect your domain with free SSL
Step 1 β Set up the DNS
In your domain registrar's dashboard (Cloudflare, Namecheap, GoDaddy...), create a record:
- Type
- A
- Name/Host
- @ (root domain) or a subdomain, e.g. app
- Content/Value
- Your server's public IP
Wait 5 to 15 minutes for the record to propagate across the internet.
Step 2 β Automatic reverse proxy with Caddy
One single file, no Nginx config or manual certificates β Caddy issues and renews Let's Encrypt HTTPS on its own.
Create a file called Caddyfile:
yourdomain.com {
reverse_proxy localhost:3000
}Start Caddy with this command (pulls the image and runs it in the background):
docker run -d -p 80:80 -p 443:443 --name caddy --restart always -v $PWD/Caddyfile:/etc/caddy/Caddyfile -v caddy_data:/data caddy