161 lines
4.5 KiB
Markdown
161 lines
4.5 KiB
Markdown
# 🏠 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)
|
|
|
|
```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!
|