ScriptsApr 16, 2026·3 min read

Dashy — Self-Hosted Dashboard for Your Homelab

Dashy is a highly customizable, self-hosted dashboard application for organizing your services, bookmarks, and monitoring widgets in a beautiful interface.

TL;DR
Dashy organizes your homelab services, bookmarks, and widgets in a customizable dashboard.
§01

What it is

Dashy is a highly customizable, self-hosted dashboard application. It organizes your services, bookmarks, monitoring widgets, and quick-access links in a single interface. You configure everything in a YAML file, and Dashy renders a responsive grid with icons, status indicators, and search.

Dashy targets homelab enthusiasts, self-hosters, and small teams who run multiple services and want a single launch page instead of remembering dozens of URLs.

§02

How it saves time or tokens

Dashy replaces browser bookmark folders with a visual, searchable dashboard. Status checks run automatically, so you see at a glance which services are up or down. The search bar lets you find any service instantly instead of scrolling through bookmark lists.

For AI-assisted infrastructure management, Dashy's YAML config is easy for agents to generate and update programmatically.

§03

How to use

  1. Deploy with Docker: docker run -d -p 4000:80 lissy93/dashy
  2. Edit the config file at /app/user-data/conf.yml
  3. Add sections and items with URLs, icons, and descriptions
  4. Reload the dashboard to see changes
§04

Example

# conf.yml
pageInfo:
  title: My Homelab
  navLinks:
    - title: GitHub
      path: https://github.com

sections:
  - name: Infrastructure
    items:
      - title: Proxmox
        url: https://proxmox.local:8006
        icon: hl-proxmox
        statusCheck: true
      - title: Portainer
        url: https://portainer.local:9443
        icon: hl-portainer
        statusCheck: true
  - name: Media
    items:
      - title: Plex
        url: https://plex.local:32400
        icon: hl-plex
      - title: Jellyfin
        url: https://jellyfin.local:8096
        icon: hl-jellyfin
§05

Related on TokRepo

§06

Common pitfalls

  • Status checks make HTTP requests from the Dashy container; ensure network connectivity to internal services
  • Large dashboards with many status checks can be slow; stagger check intervals or disable checks for stable services
  • Dashy stores config in a single YAML file; back it up before making changes to avoid losing your layout

Frequently Asked Questions

How does Dashy compare to Homepage or Homarr?+

All three are self-hosted dashboards. Dashy focuses on customization with themes, widgets, and a config editor. Homepage is simpler with service-specific integrations. Homarr is drag-and-drop oriented. Dashy offers the most visual customization options.

Does Dashy support authentication?+

Yes. Dashy supports Keycloak, Authelia, and basic HTTP authentication via reverse proxy. You can also use the built-in authentication with username/password configured in the YAML file.

Can I use custom icons in Dashy?+

Yes. Dashy supports multiple icon sources: dashboard-icons (hl- prefix), Font Awesome (fa- prefix), Material Design Icons (mdi- prefix), favicon auto-fetching, and custom image URLs.

Does Dashy work on mobile devices?+

Yes. The dashboard is fully responsive and works on phones and tablets. You can install it as a Progressive Web App (PWA) for a native app-like experience on mobile.

How do I update Dashy?+

Pull the latest Docker image and restart the container. Your config file is stored in a volume and persists across updates. Check the changelog for breaking changes before upgrading.

Citations (3)
  • Dashy GitHub— Dashy is a self-hosted dashboard application
  • Dashy Docs— Dashy supports multiple icon sources and themes
  • MDN Web Docs— Progressive Web App standards for installable web applications

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets