# Dashy Dashboard

> Feature-rich, highly customizable dashboard for self-hosted services.

- Category: Home Lab & Self-Hosting
- Difficulty: beginner
- Components: dashy
- Tags: dashboard, dashy, customizable, monitoring, homelab
- Source: https://docker.recipes/homelab/dashy-dashboard

## Overview

Dashy is an open-source, self-hosted dashboard application created by Alicia Sykes that serves as a centralized hub for organizing and accessing your homelab services, bookmarks, and system monitoring tools. Built with Vue.js and Node.js, Dashy offers extensive customization options through YAML configuration files, supporting themes, widgets, status monitoring, and authentication systems. The application gained popularity in the self-hosting community for its balance of powerful features and user-friendly setup, making it an ideal replacement for browser bookmark folders or basic landing pages.

This Docker stack deploys Dashy in a production-ready environment with external configuration management and network isolation. The setup mounts a local conf.yml file to handle all dashboard configuration, enabling easy customization without rebuilding containers. Dashy's built-in status checking capabilities monitor your services' health in real-time, while its widget system can display system metrics, weather information, RSS feeds, and custom integrations.

Homelab enthusiasts, system administrators managing multiple self-hosted services, and developers working with local development environments will find this stack particularly valuable. Dashy excels in environments where users need quick access to multiple web interfaces, want visual service monitoring, or require a customizable landing page that can grow with their infrastructure. The YAML-based configuration makes it especially appealing to users who prefer infrastructure-as-code approaches to dashboard management.

## Features

- YAML-based configuration system for version-controlled dashboard management
- Real-time service status monitoring with customizable health checks and response time tracking
- Multiple authentication methods including built-in login, LDAP, and OAuth integration
- Extensive theming system with dark/light modes and custom CSS injection capabilities
- Interactive widgets for system stats, weather, calendar, RSS feeds, and custom data sources
- Multi-language support with community-contributed translations
- Search functionality with keyboard shortcuts and quick access filtering
- Mobile-responsive design with touch-friendly interface and PWA support

## Use cases

- Homelab dashboard for accessing Plex, Pi-hole, pfSense, Portainer, and other self-hosted services
- Development environment portal organizing local APIs, databases, documentation, and testing tools
- NOC-style monitoring display showing service health across multiple servers and applications
- Team collaboration hub with shared bookmarks, documentation links, and project resources
- ISP or hosting provider customer portal with service status and support resources
- Personal productivity dashboard combining calendar widgets, weather, news feeds, and quick links
- Educational lab environment organizing student access to various learning platforms and tools

## Prerequisites

- Docker Engine 20.10+ and Docker Compose V2 for container orchestration
- Minimum 512MB RAM allocation for Node.js application and configuration processing
- Port 4000 available on host system or alternative port configuration
- Basic YAML syntax knowledge for creating and maintaining dashboard configuration
- Network access to services you want to monitor for status checking functionality
- SSL certificates if planning to enable HTTPS and authentication features

## docker-compose.yml

```yaml
services:
  dashy:
    image: lissy93/dashy:latest
    container_name: dashy
    volumes:
      - ./conf.yml:/app/public/conf.yml
    ports:
      - "4000:80"
    environment:
      - NODE_ENV=production
    networks:
      - dashy-network
    restart: unless-stopped

networks:
  dashy-network:
    driver: bridge
```

## .env

```bash
# Dashy
# Configure via conf.yml file
```

## Usage notes

- Dashboard at http://localhost:4000
- YAML configuration
- Status checking built-in
- Widgets and themes
- Authentication options

## Troubleshooting

- Configuration not loading after changes: Restart the Dashy container as configuration changes require container restart to take effect
- Service status checks showing as down: Verify network connectivity and ensure target services accept requests from Dashy's Docker network
- Themes not applying correctly: Clear browser cache and ensure custom CSS syntax is valid in the conf.yml file
- Authentication failing after setup: Check that user credentials are properly hashed in configuration and session storage is persistent
- Widgets displaying empty data: Verify API endpoints are accessible and authentication tokens are valid for external data sources
- Container failing to start: Ensure conf.yml file exists in the mounted path and contains valid YAML syntax without tabs

