Back to all templates
Homarr logo

Homarr

Infrastructure256MB+ RAM

Modern server dashboard with Docker integration and service monitoring

dashboarddockermonitoringhomepage

Deploy Homarr in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Homarr

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Homarr on a VPS with Server Compass

Use the Homarr 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
1
Step 1

Open 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.

Server Compass Apps tab before creating a Homarr app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Homarr

Use the template picker search to find Homarr in the Server Compass template catalog.

Searching for Homarr in the Server Compass template picker
4
Step 4

Select the Homarr template

Choose the Homarr template. Server Compass fills the dashboard service, persistent config volume, and public port.

Homarr template selected in Server Compass
5
Step 5

Review the Homarr settings

Confirm the app name and compose service. In this run, the app was named homarr-demo and used host port 7575.

Reviewing Homarr project settings and compose service
6
Step 6

Deploy Homarr

Review the generated compose settings, confirm the Homarr web port is available, and click Deploy.

Reviewing Homarr port and volume before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Homarr image, starts the container, and verifies the stack.

Server Compass deploying the Homarr template on the VPS
8
Step 8

Confirm Homarr is running

After deployment finishes, return to the Apps tab and confirm the Homarr app is marked Running with its application URL available.

Homarr template running in the Server Compass Apps tab
9
Step 9

Open Homarr in the browser

Open the application URL in a browser. The Homarr dashboard confirms the self-hosted start page is reachable.

The deployed Homarr web UI loaded in a browser

After Homarr Opens

  • Configure authentication before exposing Homarr 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 Homarr config volume before moving or replacing the VPS.
  • Customize themes and layout after the first verified deployment.
  • Keep the Homarr image updated for dependency and security fixes.

Verified Result

The Homarr web interface loaded successfully from the deployed container.

Homarr deployment questions

What does the Homarr template deploy?

It deploys the Homarr container with a persistent user-data volume and a public web port.

Which port did the tutorial use?

The tutorial used host port 7575, which maps to the Homarr web UI on container port 7575.

Can I enable authentication?

Yes. Configure authentication in Homarr settings or place the dashboard behind an authenticated reverse proxy.

Should this become a blog post?

No. The deployment guide should live on the Homarr template detail page and be linked from the reusable template deployment docs page.

Why Self-Host Homarr?

Homarr is a modern server dashboard with deep Docker integration. It auto-discovers your running containers and provides a sleek interface to monitor and access all your services — with real-time resource usage and service integration widgets.

Auto-discovers Docker containers and adds them to your dashboard
Real-time resource monitoring for CPU, RAM, and disk
Integration widgets for Sonarr, Radarr, and other popular apps
Drag-and-drop layout customization
Weather, calendar, and other utility widgets

Homarr vs Alternatives

Homarr vs Dashy

Dashy is more customizable. Homarr offers deeper Docker integration with auto-discovery and container management.

Homarr vs Portainer

Portainer is for Docker management. Homarr is a user-friendly dashboard for accessing and monitoring your services.

Homarr vs Homepage

Homepage uses config files. Homarr has a GUI-based setup with Docker auto-discovery for easier configuration.

Why Deploy Homarr with Server Compass?

Server Compass deploys Homarr with Docker socket access for container auto-discovery. It immediately detects your other deployed services and adds them to your dashboard.

Download Server Compass

After Deployment

After deploying Homarr with Server Compass, complete these steps to finish setup

1

Access the dashboard

2

Add service tiles

3

Configure Docker integration

Need help? Check out our documentation for detailed guides.

Homarr FAQ

Common questions about self-hosting Homarr

How do I deploy Homarr with Server Compass?

Simply download Server Compass, connect to your VPS, and select Homarr 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 Homarr?

Homarr requires a minimum of 256MB 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 Homarr data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Homarr backup and restore procedures.

How do I update Homarr to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Homarr image will be pulled and deployed with zero downtime.

Is Homarr free to self-host?

Homarr 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 Homarr?

Download Server Compass and deploy Homarr to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass