1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Homepage
Infrastructure128MB+ RAM
Modern application dashboard with service integrations and widgets
dashboardhomepagewidgetsintegrations
Deploy Homepage in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Homepage
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Homepage on a VPS with Server Compass
Use the Homepage template in Server Compass to deploy a customizable self-hosted dashboard on your VPS, then verify the web UI in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Homepage
Use the template picker search to find Homepage in the Server Compass template catalog.
4
Step 4Select the Homepage template
Choose the Homepage template. Server Compass fills the dashboard service, persistent config volume, and public port.
5
Step 5Review the Homepage settings
Confirm the app name and compose service. In this run, the app was named homepage-dash-demo and used host port 3000.
6
Step 6Deploy Homepage
Review the generated compose settings, confirm the Homepage web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Homepage image, starts the container, and verifies the stack.
8
Step 8Confirm Homepage is running
After deployment finishes, return to the Apps tab and confirm the Homepage app is marked Running with its application URL available.
9
Step 9Open Homepage in the browser
Open the application URL in a browser. The Homepage dashboard confirms the self-hosted start page is reachable.
After Homepage Opens
- Configure authentication before exposing Homepage beyond trusted networks.
- Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
- Add only the service links and widgets that should be visible from the dashboard.
- Back up the Homepage config volume before moving or replacing the VPS.
- Customize themes and layout after the first verified deployment.
- Keep the Homepage image updated for dependency and security fixes.
Verified Result
The Homepage web interface loaded successfully from the deployed container.
Homepage deployment questions
What does the Homepage template deploy?
It deploys the Homepage container with a persistent user-data volume and a public web port.
Which port did the tutorial use?
The tutorial used host port 3000, which maps to the Homepage web UI on container port 3000.
Can I enable authentication?
Yes. Configure authentication in Homepage settings or place the dashboard behind an authenticated reverse proxy.
Should this become a blog post?
No. The deployment guide should live on the Homepage template detail page and be linked from the reusable template deployment docs page.
Why Self-Host Homepage?
Homepage is a modern dashboard with deep service integrations and informational widgets. It pulls live data from your services — showing download status, media counts, resource usage, and more — all in a clean, fast interface.
Live data widgets pulling from 50+ self-hosted services
Extremely fast — static generation with background data refresh
Organized service groups with customizable icons
Bookmarks section for external services and quick links
YAML configuration for easy version control and backup
Homepage vs Alternatives
Homepage vs Homarr
Homarr has Docker auto-discovery. Homepage offers more service integration widgets showing live data from your apps.
Homepage vs Dashy
Dashy is more visual. Homepage is faster and has deeper data integrations with 50+ services.
Homepage vs Heimdall
Heimdall is basic bookmarks. Homepage shows live data, resource usage, and service status in real-time.
Why Deploy Homepage with Server Compass?
Server Compass deploys Homepage with persistent configuration for your services.yaml and widgets.yaml files. Edit the config files and Homepage picks up changes automatically.
Download Server CompassAfter Deployment
After deploying Homepage with Server Compass, complete these steps to finish setup
1
Edit services.yaml to add your services
2
Configure widgets in widgets.yaml
3
Customize settings in settings.yaml
Need help? Check out our documentation for detailed guides.
Homepage FAQ
Common questions about self-hosting Homepage
How do I deploy Homepage with Server Compass?
Simply download Server Compass, connect to your VPS, and select Homepage from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Homepage?
Homepage requires a minimum of 128MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Homepage data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Homepage backup and restore procedures.
How do I update Homepage to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Homepage image will be pulled and deployed with zero downtime.
Is Homepage free to self-host?
Homepage is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host Homepage?
Download Server Compass and deploy Homepage to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass