# 🏠 Homarr Ultimate Dashboard Stack

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

![Dashboard Preview](https://homarr.dev/img/pages/home/page.webp)

## ✨ 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)

```bash
# 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

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

## 🚀 Quick Start (Without Git)

```bash
# 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](DEPLOYMENT.md)** - Complete deployment guide
- **[GITEA_SETUP.md](GITEA_SETUP.md)** - Gitea repository setup & webhooks
- **[config/board-layouts.md](config/board-layouts.md)** - Board layout examples

## 🔗 Useful Links

- [Homarr](https://homarr.dev/) - Dashboard documentation
- [Dash.](https://getdashdot.com/) - System monitoring
- [lemonlink.eu](https://lemonlink.eu) - Your awesome website!

## 📄 License

MIT - Free to use and modify!