Self-hosted homelab dashboard

Your services. Beautifully organized.

The free, open-source start page for your homelab. Every service one click away, recognized with its own logo, in a design that feels like yours. One small container, no cloud, no telemetry.

HomeGrid on desktop and mobile

HomeGrid dashboard with an alpine lake background: favorites, a search field that also searches the web, and categories for media, files and documents with service logos such as Jellyfin, Immich and Nextcloud, each with a green online dot.
The same HomeGrid dashboard on a phone, with full-width application cards.

Add a service in seconds

Type an address. Get the right logo.

HomeGrid recognizes well-known services from their name, hostname or default port and selects the matching logo for you. Keep it, or return to the previous icon with one click.

  • More than 2,500 bundled service logos, with 343 ready-made templates. Pick one and enter its URL.
  • Existing applications and imports get logo suggestions to review. Uploaded images are never replaced.
  • Logos ship with HomeGrid and work offline. Search local icons, pick a color, upload an image or use the browser favicon.
Add application dialog: after entering https://gitea.home.arpa, HomeGrid fills in the name Gitea and reports that it recognized Gitea and selected its logo.
Enter the URL; the name and logo follow.

Find anything in a keystroke

Ctrl+K. Type. Go.

Quick search finds services by name, description and category. If you like, the same search continues on the web, so HomeGrid can be your browser's start page.

  • Web search with DuckDuckGo, Startpage, Brave Search, Google, Bing or your own SearXNG. Off until you choose one.
  • Favorites stay at the top of the dashboard, one click away.
  • Fully keyboard accessible: arrow keys to choose, Enter to open.
Quick search for pro lists Proxmox, Nginx Proxy Manager and Prometheus, followed by the option to search the web for pro via DuckDuckGo.
Your services first, the web one arrow key away.

Move over in minutes

Bring your old dashboard along.

Import services.yaml and bookmarks.yaml from Homepage, config.yml from Homer or conf.yml from Dashy. HomeGrid takes over names, links, descriptions and groups and recognizes the logos.

  • A preview shows what will be added before anything changes. Merge with your current setup or replace it.
  • Widgets and templated links that only the old dashboard can resolve are skipped and counted.
  • HomeGrid's own JSON export moves your configuration between installations.
Backup settings with an import preview of a Homepage configuration: three applications, three categories, one skipped entry and three recognized logos.
Every import starts with a preview.

Designs and layouts

Twenty looks. Endless combinations.

Photographs, gradients or a calm plain page, in light or dark. Cards, tiles or a list, one to three groups per row, compact or comfortable. Every look below is the same dashboard.

Organize in place

Arrange it the way you think.

Everyday use stays calm. When you want to rearrange, turn on Organize and work directly on the dashboard.

Drag and drop

Move cards and categories with drag-and-drop, keyboard sorting or explicit controls, including into empty or collapsed groups.

See what is online

An optional dot next to each name shows whether the service answers. Off by default, at most one request per address and minute, no history.

Undo for 30 minutes

Deletions, ordering and appearance changes can be undone for 30 minutes, even after a restart. Conflicting undos are refused.

Install it like an app

Add HomeGrid to your phone's home screen or install it on the desktop. It opens in its own window, and you stay signed in while you use it.

Tidy storage

Review icons and backgrounds that nothing uses anymore and delete them after confirming. Recent uploads are kept.

Choose your atmosphere

A dashboard that looks like yours.

Start from a preset, then adjust each layer on its own: light, dark or system mode, surface palette, accent color and background. Appearance and layout share a live preview; nothing changes until you save.

20
presets
18
surface palettes
12
gradients
12
bundled photos

Or use your own background image. Choose cards, tiles or a list, the dashboard width, columns, density and corners.

HomeGrid appearance settings with a gallery of photo and gradient presets and a live preview of the selected look.
Presets, palettes and backgrounds with a live preview.

Small by design

Private by default.

HomeGrid is one Go executable with an embedded frontend and SQLite storage. It runs on your hardware and needs no outside service.

One locked-down container

Runs as a non-root user with a read-only root filesystem and dropped capabilities. No Docker socket required.

No telemetry, no cloud

No analytics and no hosted account. Bundled icons and backgrounds work offline. The backend only asks a service for its icon when you add one HomeGrid does not know yet, and checks whether services answer only if you turn that on.

Hardened sign-in

One local administrator with argon2id password hashing, strict same-site session cookies, CSRF and origin checks, rate limiting and a restrictive Content Security Policy.

Read the security model

Quick start

Running in a minute.

  1. Download the Compose file of the current release into a directory on your Docker host.
  2. Start the container.
  3. Open http://<docker-host-ip>:8095 and create your administrator account.

There are no default credentials. Compose publishes on all host interfaces, so complete setup from a trusted network. The image supports AMD64 and ARM64, including a Raspberry Pi with a 64-bit operating system. Then add services from 343 templates or import your Homepage, Homer or Dashy configuration.

Configuration, HTTPS and backups

Download the Compose file
curl -fsSLo docker-compose.yml https://github.com/bifrost0x/homegrid/releases/download/v0.1.0/docker-compose-0.1.0.yml
Start HomeGrid
docker compose up -d --wait

Bring your homelab home.

Free and open source under the Apache License 2.0, made with love for the homelab community.

Support HomeGrid

Keep it growing.

If HomeGrid makes your homelab a little nicer, a donation helps keep it maintained and free for everyone.

Bug reports and ideas are just as welcome: open an issue.