🏠 Homarr Ultimate Dashboard Stack

A complete, production-ready Homarr deployment with system monitoring, RSS feeds, and a sleek dark theme inspired by lemonlink.eu.

✨ Features

• 🎨 Dark Theme - Matching lemonlink.eu aesthetic
• 📊 System Monitoring - Full Dash. integration
• 📰 RSS Feeds - Homelab, Cyber, Tech news
• 🔐 Public/Private Boards - Granular access control
• 🐳 Docker Management - Manage containers from dashboard
• 🚀 Auto-updates - Watchtower for automatic updates
• 🌐 NPM Ready - Pre-configured for Nginx Proxy Manager
• 🦊 Gitea Repo - Version controlled deployment

📁 Project Structure

homarr-dashboard/
├── .git/                    # Gitea repository
├── .env                     # Environment configuration (local only)
├── .env.example             # Environment template
├── .gitignore               # Git ignore rules
├── docker-compose.yml       # Main deployment file
├── deploy.sh                # Initial deployment script
├── update.sh                # Update from Gitea script
├── README.md                # This file
├── DEPLOYMENT.md            # Complete deployment guide
├── GITEA_SETUP.md           # Gitea repository setup
└── config/                  # Configuration files
    ├── apps.json            # 60+ pre-configured apps
    ├── rss-feeds.json       # Curated RSS feeds
    ├── board-layouts.md     # Board layout examples
    └── homarr-themes.md     # Theme configurations

🦊 Gitea Repository

Repo: gitea.lemonlink.eu/homelab/homarr-dashboard

Quick Deploy (Initial)

# On your server
mkdir -p /opt/homelab
cd /opt/homelab

# Clone from Gitea
git clone https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
cd homarr-dashboard

# Configure
cp .env.example .env
nano .env  # Edit settings

# Ensure NPM network exists
docker network create npm-network 2>/dev/null || true

# Deploy
chmod +x deploy.sh
./deploy.sh

Quick Update

cd /opt/homelab/homarr-dashboard
./update.sh

🚀 Quick Start (Without Git)

# 1. Copy to your server
cp -r homarr-deploy /opt/
cd /opt/homarr-deploy

# 2. Configure environment
cp .env.example .env
# Edit .env with your settings

# 3. Ensure NPM network exists
docker network create npm-network 2>/dev/null || true

# 4. Start services
docker compose up -d

# 5. Access dashboard
# http://your-server-ip:7575

📋 What's Included

Dashboards

Board	Purpose	Visibility
Main Dashboard	Quick links & news	Public
Infrastructure	Server management	Private
Media Center	Media server control	Private
System Overview	Full monitoring	Private
News Hub	RSS aggregation	Public

Widgets

• ⏰ Clock - Date and time
• 🌤️ Weather - Current conditions
• 📰 RSS Feed - Multiple news sources
• 📊 System Health - Proxmox integration
• 📈 Dash. iFrame - Full system monitoring
• 🖥️ Media Server - Active sessions
• ⬇️ Torrent/Usenet - Download progress

Apps (60+)

• 🏠 Infrastructure: Proxmox, Portainer, TrueNAS, Pi-hole, NPM
• 📊 Monitoring: Grafana, Prometheus, Uptime Kuma, Netdata
• 🎬 Media: Plex, Jellyfin, Sonarr, Radarr, *arr stack
• 📁 Productivity: Nextcloud, Immich, Vaultwarden
• 💻 Development: GitLab, Jenkins, Registry
• 🏠 Smart Home: Home Assistant, Node-RED
• 🌐 External: Gmail, GitHub, Reddit, YouTube

🌐 NPM Configuration

Add these Proxy Hosts in Nginx Proxy Manager:

Dashboard (Homarr)

Setting	Value
Domain Names	dashboard.lemonlink.eu
Forward Hostname/IP	homarr
Forward Port	7575

System Monitor (Dash.)

Setting	Value
Domain Names	system.lemonlink.eu
Forward Hostname/IP	dash
Forward Port	3001

Enable SSL for both with Let's Encrypt.

📖 Documentation

• DEPLOYMENT.md - Complete deployment guide
• GITEA_SETUP.md - Gitea repository setup & webhooks
• config/board-layouts.md - Board layout examples

🔗 Useful Links

• Homarr - Dashboard documentation
• Dash. - System monitoring
• lemonlink.eu - Your awesome website!

📄 License

MIT - Free to use and modify!