Initial Homarr dashboard configuration
Features: - Homarr 1.0 beta with dark theme matching lemonlink.eu - Dash. system monitoring integration - 60+ pre-configured apps - RSS feeds for homelab, cybersecurity, and tech news - Nginx Proxy Manager ready configuration - Watchtower auto-updates - Gitea repository setup - Automated update script
This commit is contained in:
commit
3a503cddf9
|
|
@ -0,0 +1,92 @@
|
|||
#======================================================================#
|
||||
# Homarr Environment Configuration #
|
||||
# Copy this file to .env and customize values #
|
||||
#======================================================================#
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Repository Info #
|
||||
#------------------------------------------------------------------#
|
||||
# Repo: gitea.lemonlink.eu/homelab/homarr-dashboard
|
||||
# Clone: git clone https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Security #
|
||||
#------------------------------------------------------------------#
|
||||
# Generate a secure 64-character hex string for encryption
|
||||
# PowerShell: -join ((1..32) | ForEach-Object { '{0:x2}' -f (Get-Random -Maximum 256) })
|
||||
# Linux/Mac: openssl rand -hex 32
|
||||
SECRET_ENCRYPTION_KEY=4edb53b70d198494e57ce5341aeb1edb384d808df740479aac8985fc36849aeb
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Port Configuration #
|
||||
#------------------------------------------------------------------#
|
||||
# Change if ports are already in use
|
||||
HOMARR_PORT=7575
|
||||
DASH_PORT=3001
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Domain Configuration (for reference) #
|
||||
#------------------------------------------------------------------#
|
||||
# Configure these in NPM:
|
||||
# - dashboard.lemonlink.eu → http://homarr:7575
|
||||
# - system.lemonlink.eu → http://dash:3001
|
||||
DOMAIN=lemonlink.eu
|
||||
DASHBOARD_SUBDOMAIN=dashboard
|
||||
SYSTEM_SUBDOMAIN=system
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Authentication #
|
||||
#------------------------------------------------------------------#
|
||||
# Options: credentials, ldap, oidc (can be comma-separated)
|
||||
AUTH_PROVIDERS=credentials
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# OIDC Configuration (Optional) #
|
||||
# Uncomment and configure if using OIDC/Authelia/Authentik #
|
||||
#------------------------------------------------------------------#
|
||||
# AUTH_OIDC_URI=https://auth.lemonlink.eu
|
||||
# AUTH_OIDC_CLIENT_ID=homarr
|
||||
# AUTH_OIDC_CLIENT_SECRET=your-client-secret
|
||||
# AUTH_OIDC_CLIENT_NAME=Homarr
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# LDAP Configuration (Optional) #
|
||||
# Uncomment and configure if using LDAP/Active Directory #
|
||||
#------------------------------------------------------------------#
|
||||
# AUTH_LDAP_URI=ldap://ldap.lemonlink.eu:389
|
||||
# AUTH_LDAP_BASE=dc=lemonlink,dc=eu
|
||||
# AUTH_LDAP_BIND_DN=cn=admin,dc=lemonlink,dc=eu
|
||||
# AUTH_LDAP_BIND_PASSWORD=your-ldap-password
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Dash. Configuration #
|
||||
#------------------------------------------------------------------#
|
||||
# Speed test interval in minutes (0 to disable)
|
||||
DASH_SPEED_TEST_INTERVAL=240
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Watchtower Configuration #
|
||||
#------------------------------------------------------------------#
|
||||
# Check interval in seconds (86400 = 24 hours)
|
||||
WATCHTOWER_INTERVAL=86400
|
||||
|
||||
# Optional: Discord/Slack notifications
|
||||
# WATCHTOWER_NOTIFICATIONS=shoutrrr+discord://token@id
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Database #
|
||||
#------------------------------------------------------------------#
|
||||
# SQLite (default) - no additional config needed
|
||||
DB_URL=/appdata/db/homarr.db
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Logging #
|
||||
#------------------------------------------------------------------#
|
||||
LOG_LEVEL=info
|
||||
NODE_ENV=production
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Analytics (Optional) #
|
||||
#------------------------------------------------------------------#
|
||||
# Set to false to disable anonymous analytics
|
||||
ANALYTICS_ENABLED=true
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
#======================================================================#
|
||||
# Git Ignore for Homarr Dashboard #
|
||||
#======================================================================#
|
||||
|
||||
# Environment files (contain secrets)
|
||||
.env
|
||||
.env.local
|
||||
.env.*.local
|
||||
|
||||
# Runtime data
|
||||
homarr/appdata/
|
||||
homarr/data/
|
||||
dash/
|
||||
*.db
|
||||
*.db-journal
|
||||
|
||||
# Logs
|
||||
*.log
|
||||
logs/
|
||||
|
||||
# Backups
|
||||
backups/
|
||||
|
||||
# OS files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
desktop.ini
|
||||
|
||||
# Editor files
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# Temporary files
|
||||
*.tmp
|
||||
*.temp
|
||||
.cache/
|
||||
|
||||
# Docker volumes
|
||||
volumes/
|
||||
|
|
@ -0,0 +1,463 @@
|
|||
# 🚀 Homarr Deployment Guide
|
||||
|
||||
Complete deployment guide for Homarr with system monitoring, RSS feeds, and a sleek dark theme matching lemonlink.eu.
|
||||
|
||||
## 📋 Table of Contents
|
||||
|
||||
1. [Overview](#overview)
|
||||
2. [Prerequisites](#prerequisites)
|
||||
3. [Quick Start](#quick-start)
|
||||
4. [Configuration](#configuration)
|
||||
5. [Board Setup](#board-setup)
|
||||
6. [Public/Private Access](#publicprivate-access)
|
||||
7. [Troubleshooting](#troubleshooting)
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This deployment includes:
|
||||
|
||||
| Component | Purpose |
|
||||
|-----------|---------|
|
||||
| **Homarr 1.0** | Modern dashboard with drag-and-drop |
|
||||
| **Dash.** | Real-time system monitoring |
|
||||
| **Traefik** | Reverse proxy for public access |
|
||||
| **Watchtower** | Automatic container updates |
|
||||
|
||||
### Features
|
||||
|
||||
- ✅ **5 Pre-configured Boards**: Main, Infrastructure, Media, System, News
|
||||
- ✅ **60+ Apps**: Pre-configured with icons and categories
|
||||
- ✅ **System Monitoring**: Full Dash. integration with CPU/RAM/Storage/Network
|
||||
- ✅ **RSS Feeds**: Homelab, Cybersecurity, and Technology news
|
||||
- ✅ **Dark Theme**: Matching lemonlink.eu aesthetic
|
||||
- ✅ **Public/Private Boards**: Granular access control
|
||||
- ✅ **Docker Integration**: Manage containers from dashboard
|
||||
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
||||
### System Requirements
|
||||
|
||||
- **OS**: Linux (Ubuntu 20.04+, Debian 11+, etc.)
|
||||
- **Docker**: 20.10+ with Docker Compose v2
|
||||
- **RAM**: 2GB minimum, 4GB recommended
|
||||
- **Storage**: 5GB free space
|
||||
|
||||
### Install Docker (if not installed)
|
||||
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
curl -fsSL https://get.docker.com | sh
|
||||
sudo usermod -aG docker $USER
|
||||
newgrp docker
|
||||
|
||||
# Verify installation
|
||||
docker --version
|
||||
docker compose version
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. Clone or Copy Files
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
# Copy the homarr-deploy folder to your server
|
||||
cp -r homarr-deploy /opt/
|
||||
cd /opt/homarr-deploy
|
||||
```
|
||||
|
||||
### 2. Configure Environment
|
||||
|
||||
```bash
|
||||
# Copy example environment file
|
||||
cp .env.example .env
|
||||
|
||||
# Edit configuration
|
||||
nano .env
|
||||
|
||||
# Generate a new encryption key (PowerShell)
|
||||
# -join ((1..32) | ForEach-Object { '{0:x2}' -f (Get-Random -Maximum 256) })
|
||||
```
|
||||
|
||||
### 3. Start Services
|
||||
|
||||
```bash
|
||||
# Start all services
|
||||
docker compose up -d
|
||||
|
||||
# Verify services are running
|
||||
docker compose ps
|
||||
|
||||
# View logs
|
||||
docker compose logs -f
|
||||
```
|
||||
|
||||
### 4. Access Homarr
|
||||
|
||||
- **Homarr Dashboard**: http://your-server-ip:7575
|
||||
- **Dash. System Monitor**: http://your-server-ip:3001
|
||||
- **Traefik Dashboard**: http://your-server-ip:8080
|
||||
|
||||
---
|
||||
|
||||
## Configuration
|
||||
|
||||
### Initial Setup
|
||||
|
||||
1. **First Run**: Navigate to http://your-server-ip:7575
|
||||
2. **Onboarding**: Create admin account
|
||||
3. **Boards**: Create your first board
|
||||
|
||||
### Creating Boards
|
||||
|
||||
#### Board 1: Main Dashboard (Public)
|
||||
|
||||
```
|
||||
Navigate to: Manage → Boards → New Board
|
||||
|
||||
Name: Main Dashboard
|
||||
Visibility: Public
|
||||
Theme: LemonLink Dark (customize colors)
|
||||
```
|
||||
|
||||
**Add Widgets:**
|
||||
1. **Clock**: Large format, show date
|
||||
2. **Weather**: Your location
|
||||
3. **RSS Feed - Homelab**:
|
||||
- URLs: `https://selfh.st/rss/,https://noted.lol/rss/,https://feeds.fireside.fm/selfhosted/rss`
|
||||
- Posts limit: 10
|
||||
4. **RSS Feed - Cyber**:
|
||||
- URLs: `https://www.bleepingcomputer.com/feed/,https://feeds.feedburner.com/TheHackersNews,https://krebsonsecurity.com/feed/`
|
||||
- Posts limit: 10
|
||||
5. **RSS Feed - Tech**:
|
||||
- URLs: `https://news.ycombinator.com/rss,https://techcrunch.com/feed/,https://feeds.arstechnica.com/arstechnica/index`
|
||||
- Posts limit: 10
|
||||
|
||||
**Add Apps:**
|
||||
- Gmail, GitHub, Reddit, YouTube, Discord
|
||||
- Proxmox, Portainer, Plex, Nextcloud, Vaultwarden
|
||||
|
||||
#### Board 2: Infrastructure (Private)
|
||||
|
||||
```
|
||||
Navigate to: Manage → Boards → New Board
|
||||
|
||||
Name: Infrastructure
|
||||
Visibility: Private
|
||||
```
|
||||
|
||||
**Add Widgets:**
|
||||
1. **iFrame**: Embed Dash. (http://your-server-ip:3001)
|
||||
2. **System Health Monitor**: Connect to Proxmox
|
||||
3. **DNS Hole**: Connect to Pi-hole/AdGuard
|
||||
|
||||
**Add Apps:**
|
||||
- All infrastructure apps (see apps.json)
|
||||
|
||||
#### Board 3: Media Center (Private)
|
||||
|
||||
```
|
||||
Name: Media Center
|
||||
Visibility: Private
|
||||
```
|
||||
|
||||
**Add Widgets:**
|
||||
1. **Media Server**: Connect to Plex/Jellyfin
|
||||
2. **Torrent**: Connect to qBittorrent/Transmission
|
||||
3. **Media Requests**: Connect to Overseerr/Jellyseerr
|
||||
|
||||
#### Board 4: System Overview (Private)
|
||||
|
||||
```
|
||||
Name: System Overview
|
||||
Visibility: Private
|
||||
Layout: Full-width iFrame
|
||||
```
|
||||
|
||||
**Add Widget:**
|
||||
1. **iFrame**: Dash. at http://your-server-ip:3001 (full screen)
|
||||
|
||||
#### Board 5: News Hub (Public)
|
||||
|
||||
```
|
||||
Name: News Hub
|
||||
Visibility: Public
|
||||
```
|
||||
|
||||
**Add Widgets:**
|
||||
1. **RSS Feed - Homelab** (full width)
|
||||
2. **RSS Feed - Cybersecurity** (full width)
|
||||
3. **RSS Feed - Technology** (full width)
|
||||
|
||||
---
|
||||
|
||||
## Public/Private Access
|
||||
|
||||
### Access Control
|
||||
|
||||
| Board | Visibility | Access |
|
||||
|-------|------------|--------|
|
||||
| Main Dashboard | Public | Anyone |
|
||||
| News Hub | Public | Anyone |
|
||||
| Infrastructure | Private | Logged-in users only |
|
||||
| Media Center | Private | Logged-in users only |
|
||||
| System Overview | Private | Logged-in users only |
|
||||
|
||||
### Setting Up External Access (with NPM)
|
||||
|
||||
Since you're using Nginx Proxy Manager (NPM), the setup is straightforward:
|
||||
|
||||
#### Step 1: Ensure NPM Network Exists
|
||||
|
||||
```bash
|
||||
# Check if network exists
|
||||
docker network ls | grep npm-network
|
||||
|
||||
# Create if missing
|
||||
docker network create npm-network
|
||||
```
|
||||
|
||||
The `docker-compose.yml` is already configured to connect to the `npm-network`.
|
||||
|
||||
#### Option 1: Cloudflare Tunnel (Recommended)
|
||||
|
||||
```bash
|
||||
# Install cloudflared
|
||||
docker run --rm -v /opt/homarr-deploy/cloudflared:/home/nonroot/.cloudflared cloudflare/cloudflared:latest tunnel login
|
||||
|
||||
# Create tunnel
|
||||
docker run --rm -v /opt/homarr-deploy/cloudflared:/home/nonroot/.cloudflared cloudflare/cloudflared:latest tunnel create homarr
|
||||
|
||||
# Configure tunnel
|
||||
cat > /opt/homarr-deploy/cloudflared/config.yml << 'EOF'
|
||||
tunnel: YOUR_TUNNEL_ID
|
||||
credentials-file: /home/nonroot/.cloudflared/YOUR_TUNNEL_ID.json
|
||||
|
||||
ingress:
|
||||
- hostname: dashboard.lemonlink.eu
|
||||
service: http://homarr:7575
|
||||
- hostname: system.lemonlink.eu
|
||||
service: http://dash:3001
|
||||
- service: http_status:404
|
||||
EOF
|
||||
|
||||
# Run tunnel
|
||||
docker run -d --name cloudflared \
|
||||
-v /opt/homarr-deploy/cloudflared:/home/nonroot/.cloudflared \
|
||||
cloudflare/cloudflared:latest tunnel run
|
||||
```
|
||||
|
||||
#### Option 2: Nginx Proxy Manager
|
||||
|
||||
Add to your existing NPM:
|
||||
- **Domain**: `dashboard.lemonlink.eu`
|
||||
- **Forward Hostname/IP**: `homarr`
|
||||
- **Forward Port**: `7575`
|
||||
- **Scheme**: `http`
|
||||
|
||||
#### Option 3: Using Gitea + Webhook (Advanced)
|
||||
|
||||
See [GITEA_SETUP.md](GITEA_SETUP.md) for automated deployment via Gitea webhooks.
|
||||
|
||||
---
|
||||
|
||||
## Dash. Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
The Dash. container is pre-configured with:
|
||||
|
||||
```yaml
|
||||
environment:
|
||||
- DASHDOT_ENABLE_CPU_TEMPS=true
|
||||
- DASHDOT_ALWAYS_SHOW_PERCENTAGES=true
|
||||
- DASHDOT_ENABLE_STORAGE_SPLIT_VIEW=true
|
||||
- DASHDOT_SPEED_TEST_INTERVAL=240
|
||||
- DASHDOT_WIDGET_LIST=os,cpu,storage,ram,network
|
||||
```
|
||||
|
||||
### Access Dash.
|
||||
|
||||
- **Direct**: http://your-server-ip:3001
|
||||
- **Embedded**: Add as iFrame widget in Homarr
|
||||
|
||||
### Customization
|
||||
|
||||
Modify `docker-compose.yml` to change:
|
||||
- Widget order
|
||||
- Display options
|
||||
- Speed test interval
|
||||
|
||||
---
|
||||
|
||||
## RSS Feed Configuration
|
||||
|
||||
### Pre-configured Feeds
|
||||
|
||||
See `config/rss-feeds.json` for complete list.
|
||||
|
||||
### Adding to Homarr
|
||||
|
||||
1. Edit board → Add Widget → RSS Feed
|
||||
2. Enter feed URLs (comma-separated)
|
||||
3. Configure display options:
|
||||
- Posts limit: 10-20
|
||||
- Description line clamp: 2-5
|
||||
- Hide description: No
|
||||
|
||||
### Feed Categories
|
||||
|
||||
| Category | Feeds |
|
||||
|----------|-------|
|
||||
| Homelab | Selfh.st, Noted, Self-Hosted Podcast, r/SelfHosted |
|
||||
| Cybersecurity | Bleeping Computer, The Hacker News, Krebs on Security |
|
||||
| Technology | Hacker News, TechCrunch, Ars Technica, Wired |
|
||||
| Linux | Phoronix, LWN, OMG! Ubuntu, Arch News |
|
||||
| Docker | Docker Blog, LinuxServer.io |
|
||||
|
||||
---
|
||||
|
||||
## Theming
|
||||
|
||||
### Dark Theme (lemonlink.eu Style)
|
||||
|
||||
Navigate to: Board Settings → Appearance
|
||||
|
||||
```
|
||||
Primary Color: #6366f1 (Indigo)
|
||||
Secondary Color: #8b5cf6 (Purple)
|
||||
Background: #0a0a0f (Near black)
|
||||
Text Color: #e2e8f0 (Light gray)
|
||||
Accent Color: #fbbf24 (Amber)
|
||||
```
|
||||
|
||||
### Custom CSS
|
||||
|
||||
Add to Board Settings → Custom CSS:
|
||||
|
||||
```css
|
||||
/* Glassmorphism effect */
|
||||
.homarr-card {
|
||||
background: rgba(255, 255, 255, 0.05) !important;
|
||||
backdrop-filter: blur(10px) !important;
|
||||
border: 1px solid rgba(255, 255, 255, 0.1) !important;
|
||||
border-radius: 16px !important;
|
||||
}
|
||||
|
||||
/* Hover animation */
|
||||
.homarr-card:hover {
|
||||
transform: translateY(-4px) !important;
|
||||
box-shadow: 0 20px 40px rgba(0, 0, 0, 0.3) !important;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Maintenance
|
||||
|
||||
### Backup
|
||||
|
||||
```bash
|
||||
# Backup Homarr data
|
||||
tar -czf homarr-backup-$(date +%Y%m%d).tar.gz homarr/
|
||||
|
||||
# Backup configurations
|
||||
tar -czf config-backup-$(date +%Y%m%d).tar.gz config/
|
||||
```
|
||||
|
||||
### Updates
|
||||
|
||||
Watchtower is configured to auto-update daily.
|
||||
|
||||
Manual update:
|
||||
```bash
|
||||
docker compose pull
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### Logs
|
||||
|
||||
```bash
|
||||
# Homarr logs
|
||||
docker compose logs -f homarr
|
||||
|
||||
# Dash. logs
|
||||
docker compose logs -f dash
|
||||
|
||||
# All logs
|
||||
docker compose logs -f
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Issue: Homarr won't start
|
||||
|
||||
```bash
|
||||
# Check logs
|
||||
docker compose logs homarr
|
||||
|
||||
# Verify permissions
|
||||
ls -la homarr/appdata/
|
||||
|
||||
# Reset permissions
|
||||
sudo chown -R $USER:$USER homarr/
|
||||
```
|
||||
|
||||
### Issue: Dash. shows no data
|
||||
|
||||
```bash
|
||||
# Ensure privileged mode is enabled
|
||||
docker compose stop dash
|
||||
docker compose rm dash
|
||||
docker compose up -d dash
|
||||
|
||||
# Check Dash. logs
|
||||
docker compose logs dash
|
||||
```
|
||||
|
||||
### Issue: RSS feeds not loading
|
||||
|
||||
- Check URL is valid and accessible
|
||||
- Ensure feed is RSS/ATOM/JSON format
|
||||
- Try accessing feed URL directly in browser
|
||||
|
||||
### Issue: Cannot access from internet
|
||||
|
||||
- Check firewall rules (ports 80, 443, 7575, 3001)
|
||||
- Verify DNS records point to server
|
||||
- Check reverse proxy configuration
|
||||
|
||||
---
|
||||
|
||||
## Security Recommendations
|
||||
|
||||
1. **Use HTTPS**: Enable SSL/TLS with Let's Encrypt
|
||||
2. **Strong Passwords**: Use password manager for admin account
|
||||
3. **Firewall**: Restrict port access
|
||||
4. **VPN**: Consider VPN for private boards
|
||||
5. **Updates**: Keep containers updated
|
||||
6. **Backups**: Regular data backups
|
||||
|
||||
---
|
||||
|
||||
## Resources
|
||||
|
||||
- [Homarr Documentation](https://homarr.dev/docs/)
|
||||
- [Dash. Documentation](https://getdashdot.com/)
|
||||
- [Docker Compose Reference](https://docs.docker.com/compose/)
|
||||
|
||||
---
|
||||
|
||||
## Support
|
||||
|
||||
For issues or questions:
|
||||
- Homarr Discord: https://discord.gg/homarr
|
||||
- GitHub Issues: https://github.com/homarr-labs/homarr/issues
|
||||
|
|
@ -0,0 +1,328 @@
|
|||
# 🦊 Gitea Repository Setup Guide
|
||||
|
||||
This guide will help you set up a Gitea repository for your Homarr dashboard configuration, enabling easy deployment and version-controlled updates.
|
||||
|
||||
## 📋 Prerequisites
|
||||
|
||||
- Gitea instance running (e.g., `gitea.lemonlink.eu`)
|
||||
- Git installed on your server
|
||||
- Docker and Docker Compose installed
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Setup Steps
|
||||
|
||||
### 1. Create Repository in Gitea
|
||||
|
||||
1. Navigate to your Gitea instance: `https://gitea.lemonlink.eu`
|
||||
2. Create a new organization (optional): `homelab`
|
||||
3. Create new repository:
|
||||
- **Repository Name**: `homarr-dashboard`
|
||||
- **Description**: "Homarr dashboard configuration with system monitoring"
|
||||
- **Visibility**: Private (recommended)
|
||||
- **Initialize**: Yes, with README
|
||||
|
||||
### 2. Push Configuration to Gitea
|
||||
|
||||
```bash
|
||||
# On your local machine (where you created the files)
|
||||
cd homarr-deploy
|
||||
|
||||
# Initialize git repo (if not already done)
|
||||
git init
|
||||
|
||||
# Add Gitea remote
|
||||
git remote add origin https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
|
||||
|
||||
# Or if using SSH:
|
||||
# git remote add origin git@gitea.lemonlink.eu:homelab/homarr-dashboard.git
|
||||
|
||||
# Add all files
|
||||
git add .
|
||||
|
||||
# Commit
|
||||
git commit -m "Initial Homarr dashboard configuration
|
||||
|
||||
Features:
|
||||
- Homarr 1.0 beta with dark theme
|
||||
- Dash. system monitoring
|
||||
- 60+ pre-configured apps
|
||||
- RSS feeds for homelab, cyber, tech news
|
||||
- Nginx Proxy Manager ready
|
||||
- Watchtower auto-updates"
|
||||
|
||||
# Push to Gitea
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
### 3. Deploy on Your Server
|
||||
|
||||
SSH into your server and run:
|
||||
|
||||
```bash
|
||||
# Create directory
|
||||
mkdir -p /opt/homelab
|
||||
cd /opt/homelab
|
||||
|
||||
# Clone repository
|
||||
git clone https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
|
||||
# Or with SSH:
|
||||
# git clone git@gitea.lemonlink.eu:homelab/homarr-dashboard.git
|
||||
|
||||
cd homarr-dashboard
|
||||
|
||||
# Configure environment
|
||||
cp .env.example .env
|
||||
nano .env # Edit with your settings
|
||||
|
||||
# Ensure NPM network exists
|
||||
docker network create npm-network 2>/dev/null || true
|
||||
|
||||
# Deploy
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Update Workflow
|
||||
|
||||
### Method 1: Pull Updates on Server
|
||||
|
||||
```bash
|
||||
cd /opt/homelab/homarr-dashboard
|
||||
git pull
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### Method 2: Using Update Script
|
||||
|
||||
The included `update.sh` script automates this:
|
||||
|
||||
```bash
|
||||
# Make executable and run
|
||||
chmod +x update.sh
|
||||
./update.sh
|
||||
```
|
||||
|
||||
### Method 3: Automatic Updates (Webhook)
|
||||
|
||||
Set up a Gitea webhook to auto-deploy on push:
|
||||
|
||||
**In Gitea:**
|
||||
1. Repository → Settings → Webhooks
|
||||
2. Add Webhook → Gitea
|
||||
3. Target URL: `https://deploy.lemonlink.eu/webhook/homarr`
|
||||
4. Secret: Generate a secure secret
|
||||
5. Events: Push
|
||||
|
||||
**On Server (optional):** Set up a simple webhook listener or use a CI/CD tool like Drone CI.
|
||||
|
||||
---
|
||||
|
||||
## 🔐 NPM Configuration
|
||||
|
||||
### Add Proxy Hosts in NPM
|
||||
|
||||
#### 1. Dashboard (Homarr)
|
||||
|
||||
| Setting | Value |
|
||||
|---------|-------|
|
||||
| Domain Names | `dashboard.lemonlink.eu` |
|
||||
| Scheme | `http` |
|
||||
| Forward Hostname/IP | `homarr` |
|
||||
| Forward Port | `7575` |
|
||||
| Cache Assets | ✅ |
|
||||
| Block Common Exploits | ✅ |
|
||||
|
||||
**SSL Tab:**
|
||||
- SSL Certificate: Request a new SSL certificate
|
||||
- Accept Terms: ✅
|
||||
- Force SSL: ✅
|
||||
- HTTP/2 Support: ✅
|
||||
- HSTS Enabled: ✅
|
||||
|
||||
#### 2. System Monitor (Dash.)
|
||||
|
||||
| Setting | Value |
|
||||
|---------|-------|
|
||||
| Domain Names | `system.lemonlink.eu` |
|
||||
| Scheme | `http` |
|
||||
| Forward Hostname/IP | `dash` |
|
||||
| Forward Port | `3001` |
|
||||
|
||||
**SSL Tab:** Same as above
|
||||
|
||||
### Ensure NPM Network Exists
|
||||
|
||||
```bash
|
||||
# Check if network exists
|
||||
docker network ls | grep npm-network
|
||||
|
||||
# Create if missing
|
||||
docker network create npm-network
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 Repository Structure
|
||||
|
||||
```
|
||||
homarr-dashboard/
|
||||
├── .git/ # Git repository
|
||||
├── .env # Environment config (not in git)
|
||||
├── .env.example # Template for .env
|
||||
├── docker-compose.yml # Main compose file
|
||||
├── deploy.sh # Initial deployment script
|
||||
├── update.sh # Update script
|
||||
├── README.md # Project readme
|
||||
├── DEPLOYMENT.md # Full deployment guide
|
||||
├── GITEA_SETUP.md # This file
|
||||
└── config/ # Configuration files
|
||||
├── apps.json
|
||||
├── rss-feeds.json
|
||||
├── board-layouts.md
|
||||
└── homarr-themes.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Version Control Best Practices
|
||||
|
||||
### Commit Messages
|
||||
|
||||
```bash
|
||||
# Good commit messages
|
||||
git commit -m "Add new RSS feeds for cybersecurity"
|
||||
git commit -m "Update Docker image to beta.3"
|
||||
git commit -m "Fix: Correct port mapping for Dash."
|
||||
git commit -m "Theme: Update primary color to match new design"
|
||||
```
|
||||
|
||||
### Branching Strategy
|
||||
|
||||
```bash
|
||||
# Production branch: main
|
||||
# Development branch: develop
|
||||
|
||||
# Feature workflow
|
||||
git checkout -b feature/add-grafana-integration
|
||||
# ... make changes ...
|
||||
git commit -am "Add Grafana integration"
|
||||
git push origin feature/add-grafana-integration
|
||||
# Create merge request in Gitea
|
||||
```
|
||||
|
||||
### Sensitive Data
|
||||
|
||||
**Never commit:**
|
||||
- `.env` file (contains secrets)
|
||||
- `homarr/appdata/` (runtime data)
|
||||
- Any files with passwords or API keys
|
||||
|
||||
**Already configured in `.gitignore`:**
|
||||
```gitignore
|
||||
.env
|
||||
homarr/appdata/
|
||||
dash/
|
||||
*.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Advanced: Drone CI Integration
|
||||
|
||||
### `.drone.yml` (optional)
|
||||
|
||||
```yaml
|
||||
kind: pipeline
|
||||
type: docker
|
||||
name: deploy
|
||||
|
||||
steps:
|
||||
- name: deploy
|
||||
image: appleboy/drone-ssh
|
||||
settings:
|
||||
host:
|
||||
from_secret: server_host
|
||||
username:
|
||||
from_secret: server_user
|
||||
password:
|
||||
from_secret: server_password
|
||||
script:
|
||||
- cd /opt/homelab/homarr-dashboard
|
||||
- git pull
|
||||
- docker compose up -d
|
||||
|
||||
when:
|
||||
branch:
|
||||
- main
|
||||
event:
|
||||
- push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Maintenance Checklist
|
||||
|
||||
- [ ] Weekly: Review and update RSS feeds
|
||||
- [ ] Monthly: Update Docker images (`docker compose pull`)
|
||||
- [ ] Monthly: Backup `homarr/appdata/` directory
|
||||
- [ ] Quarterly: Review and rotate secrets
|
||||
- [ ] As needed: Add new apps or integrations
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Troubleshooting
|
||||
|
||||
### Issue: Cannot clone repository
|
||||
|
||||
```bash
|
||||
# Test Gitea access
|
||||
curl -I https://gitea.lemonlink.eu
|
||||
|
||||
# Check SSH key (if using SSH)
|
||||
cat ~/.ssh/id_rsa.pub
|
||||
# Add to Gitea: User Settings → SSH Keys
|
||||
```
|
||||
|
||||
### Issue: NPM network not found
|
||||
|
||||
```bash
|
||||
# Create network manually
|
||||
docker network create npm-network
|
||||
|
||||
# Restart containers
|
||||
docker compose restart
|
||||
```
|
||||
|
||||
### Issue: Changes not reflecting
|
||||
|
||||
```bash
|
||||
# Force pull and recreate
|
||||
git fetch origin
|
||||
git reset --hard origin/main
|
||||
docker compose up -d --force-recreate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Useful Commands
|
||||
|
||||
```bash
|
||||
# Check repo status
|
||||
git status
|
||||
|
||||
# View commit history
|
||||
git log --oneline -10
|
||||
|
||||
# Pull latest changes
|
||||
git pull origin main
|
||||
|
||||
# See what files changed
|
||||
git diff --name-only
|
||||
|
||||
# Rollback to previous version
|
||||
git log --oneline # Find commit hash
|
||||
git checkout <commit-hash>
|
||||
docker compose up -d
|
||||
```
|
||||
|
|
@ -0,0 +1,160 @@
|
|||
# 🏠 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!
|
||||
|
|
@ -0,0 +1,494 @@
|
|||
{
|
||||
"description": "Pre-configured apps for Homarr dashboard",
|
||||
"categories": {
|
||||
"infrastructure": {
|
||||
"title": "🏠 Infrastructure",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Proxmox",
|
||||
"icon": "proxmox",
|
||||
"url": "https://proxmox.lemonlink.eu",
|
||||
"description": "Virtualization Platform",
|
||||
"integration": "proxmox"
|
||||
},
|
||||
{
|
||||
"name": "Portainer",
|
||||
"icon": "portainer",
|
||||
"url": "https://portainer.lemonlink.eu",
|
||||
"description": "Docker Management",
|
||||
"integration": "docker"
|
||||
},
|
||||
{
|
||||
"name": "TrueNAS",
|
||||
"icon": "truenas",
|
||||
"url": "https://truenas.lemonlink.eu",
|
||||
"description": "Storage Management"
|
||||
},
|
||||
{
|
||||
"name": "Pi-hole",
|
||||
"icon": "pihole",
|
||||
"url": "https://pihole.lemonlink.eu/admin",
|
||||
"description": "DNS Sinkhole",
|
||||
"integration": "pihole"
|
||||
},
|
||||
{
|
||||
"name": "AdGuard",
|
||||
"icon": "adguard",
|
||||
"url": "https://adguard.lemonlink.eu",
|
||||
"description": "Ad Blocking",
|
||||
"integration": "adguard"
|
||||
},
|
||||
{
|
||||
"name": "Nginx Proxy Manager",
|
||||
"icon": "nginx-proxy-manager",
|
||||
"url": "https://npm.lemonlink.eu",
|
||||
"description": "Reverse Proxy"
|
||||
},
|
||||
{
|
||||
"name": "Traefik",
|
||||
"icon": "traefik",
|
||||
"url": "https://traefik.lemonlink.eu",
|
||||
"description": "Edge Router"
|
||||
},
|
||||
{
|
||||
"name": "UniFi",
|
||||
"icon": "ubiquiti",
|
||||
"url": "https://unifi.lemonlink.eu",
|
||||
"description": "Network Management"
|
||||
},
|
||||
{
|
||||
"name": "OPNsense",
|
||||
"icon": "opnsense",
|
||||
"url": "https://opnsense.lemonlink.eu",
|
||||
"description": "Firewall"
|
||||
},
|
||||
{
|
||||
"name": "pfSense",
|
||||
"icon": "pfsense",
|
||||
"url": "https://pfsense.lemonlink.eu",
|
||||
"description": "Firewall/Router"
|
||||
},
|
||||
{
|
||||
"name": "Tailscale",
|
||||
"icon": "tailscale",
|
||||
"url": "https://login.tailscale.com/admin",
|
||||
"description": "VPN Mesh"
|
||||
},
|
||||
{
|
||||
"name": "WireGuard",
|
||||
"icon": "wireguard",
|
||||
"url": "https://wg.lemonlink.eu",
|
||||
"description": "VPN Server"
|
||||
},
|
||||
{
|
||||
"name": "OpenVPN",
|
||||
"icon": "openvpn",
|
||||
"url": "https://openvpn.lemonlink.eu",
|
||||
"description": "VPN Server"
|
||||
}
|
||||
]
|
||||
},
|
||||
"monitoring": {
|
||||
"title": "📊 Monitoring",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Grafana",
|
||||
"icon": "grafana",
|
||||
"url": "https://grafana.lemonlink.eu",
|
||||
"description": "Metrics Dashboard"
|
||||
},
|
||||
{
|
||||
"name": "Prometheus",
|
||||
"icon": "prometheus",
|
||||
"url": "https://prometheus.lemonlink.eu",
|
||||
"description": "Metrics Collection"
|
||||
},
|
||||
{
|
||||
"name": "Uptime Kuma",
|
||||
"icon": "uptime-kuma",
|
||||
"url": "https://uptime.lemonlink.eu",
|
||||
"description": "Uptime Monitor"
|
||||
},
|
||||
{
|
||||
"name": "Netdata",
|
||||
"icon": "netdata",
|
||||
"url": "https://netdata.lemonlink.eu",
|
||||
"description": "Real-time Monitoring"
|
||||
},
|
||||
{
|
||||
"name": "Dash.",
|
||||
"icon": "dashdot",
|
||||
"url": "http://localhost:3001",
|
||||
"description": "System Overview",
|
||||
"integration": "dashdot"
|
||||
},
|
||||
{
|
||||
"name": "Beszel",
|
||||
"icon": "beszel",
|
||||
"url": "https://beszel.lemonlink.eu",
|
||||
"description": "Server Monitoring"
|
||||
},
|
||||
{
|
||||
"name": "Scrutiny",
|
||||
"icon": "scrutiny",
|
||||
"url": "https://scrutiny.lemonlink.eu",
|
||||
"description": "SMART Monitoring"
|
||||
}
|
||||
]
|
||||
},
|
||||
"media": {
|
||||
"title": "🎬 Media",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Plex",
|
||||
"icon": "plex",
|
||||
"url": "https://plex.lemonlink.eu",
|
||||
"description": "Media Server",
|
||||
"integration": "plex"
|
||||
},
|
||||
{
|
||||
"name": "Jellyfin",
|
||||
"icon": "jellyfin",
|
||||
"url": "https://jellyfin.lemonlink.eu",
|
||||
"description": "Media Server",
|
||||
"integration": "jellyfin"
|
||||
},
|
||||
{
|
||||
"name": "Emby",
|
||||
"icon": "emby",
|
||||
"url": "https://emby.lemonlink.eu",
|
||||
"description": "Media Server",
|
||||
"integration": "emby"
|
||||
},
|
||||
{
|
||||
"name": "Sonarr",
|
||||
"icon": "sonarr",
|
||||
"url": "https://sonarr.lemonlink.eu",
|
||||
"description": "TV Shows",
|
||||
"integration": "sonarr"
|
||||
},
|
||||
{
|
||||
"name": "Radarr",
|
||||
"icon": "radarr",
|
||||
"url": "https://radarr.lemonlink.eu",
|
||||
"description": "Movies",
|
||||
"integration": "radarr"
|
||||
},
|
||||
{
|
||||
"name": "Lidarr",
|
||||
"icon": "lidarr",
|
||||
"url": "https://lidarr.lemonlink.eu",
|
||||
"description": "Music",
|
||||
"integration": "lidarr"
|
||||
},
|
||||
{
|
||||
"name": "Readarr",
|
||||
"icon": "readarr",
|
||||
"url": "https://readarr.lemonlink.eu",
|
||||
"description": "Books",
|
||||
"integration": "readarr"
|
||||
},
|
||||
{
|
||||
"name": "Bazarr",
|
||||
"icon": "bazarr",
|
||||
"url": "https://bazarr.lemonlink.eu",
|
||||
"description": "Subtitles",
|
||||
"integration": "bazarr"
|
||||
},
|
||||
{
|
||||
"name": "Prowlarr",
|
||||
"icon": "prowlarr",
|
||||
"url": "https://prowlarr.lemonlink.eu",
|
||||
"description": "Indexer Manager",
|
||||
"integration": "prowlarr"
|
||||
},
|
||||
{
|
||||
"name": "Overseerr",
|
||||
"icon": "overseerr",
|
||||
"url": "https://overseerr.lemonlink.eu",
|
||||
"description": "Media Requests",
|
||||
"integration": "overseerr"
|
||||
},
|
||||
{
|
||||
"name": "Jellyseerr",
|
||||
"icon": "jellyseerr",
|
||||
"url": "https://jellyseerr.lemonlink.eu",
|
||||
"description": "Media Requests",
|
||||
"integration": "jellyseerr"
|
||||
},
|
||||
{
|
||||
"name": "Transmission",
|
||||
"icon": "transmission",
|
||||
"url": "https://transmission.lemonlink.eu",
|
||||
"description": "BitTorrent",
|
||||
"integration": "transmission"
|
||||
},
|
||||
{
|
||||
"name": "qBittorrent",
|
||||
"icon": "qbittorrent",
|
||||
"url": "https://qbittorrent.lemonlink.eu",
|
||||
"description": "BitTorrent",
|
||||
"integration": "qbittorrent"
|
||||
},
|
||||
{
|
||||
"name": "Deluge",
|
||||
"icon": "deluge",
|
||||
"url": "https://deluge.lemonlink.eu",
|
||||
"description": "BitTorrent",
|
||||
"integration": "deluge"
|
||||
},
|
||||
{
|
||||
"name": "SABnzbd",
|
||||
"icon": "sabnzbd",
|
||||
"url": "https://sabnzbd.lemonlink.eu",
|
||||
"description": "Usenet",
|
||||
"integration": "sabnzbd"
|
||||
},
|
||||
{
|
||||
"name": "NZBGet",
|
||||
"icon": "nzbget",
|
||||
"url": "https://nzbget.lemonlink.eu",
|
||||
"description": "Usenet",
|
||||
"integration": "nzbget"
|
||||
},
|
||||
{
|
||||
"name": "Tdarr",
|
||||
"icon": "tdarr",
|
||||
"url": "https://tdarr.lemonlink.eu",
|
||||
"description": "Transcoding"
|
||||
}
|
||||
]
|
||||
},
|
||||
"productivity": {
|
||||
"title": "📁 Productivity",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Nextcloud",
|
||||
"icon": "nextcloud",
|
||||
"url": "https://cloud.lemonlink.eu",
|
||||
"description": "Cloud Storage"
|
||||
},
|
||||
{
|
||||
"name": "Immich",
|
||||
"icon": "immich",
|
||||
"url": "https://photos.lemonlink.eu",
|
||||
"description": "Photo Backup"
|
||||
},
|
||||
{
|
||||
"name": "Paperless",
|
||||
"icon": "paperless",
|
||||
"url": "https://paperless.lemonlink.eu",
|
||||
"description": "Document Management"
|
||||
},
|
||||
{
|
||||
"name": "Vaultwarden",
|
||||
"icon": "vaultwarden",
|
||||
"url": "https://vault.lemonlink.eu",
|
||||
"description": "Password Manager"
|
||||
},
|
||||
{
|
||||
"name": "Bookstack",
|
||||
"icon": "bookstack",
|
||||
"url": "https://wiki.lemonlink.eu",
|
||||
"description": "Documentation"
|
||||
},
|
||||
{
|
||||
"name": "Miniflux",
|
||||
"icon": "miniflux",
|
||||
"url": "https://rss.lemonlink.eu",
|
||||
"description": "RSS Reader"
|
||||
},
|
||||
{
|
||||
"name": "FreshRSS",
|
||||
"icon": "freshrss",
|
||||
"url": "https://freshrss.lemonlink.eu",
|
||||
"description": "RSS Reader"
|
||||
},
|
||||
{
|
||||
"name": "Joplin",
|
||||
"icon": "joplin",
|
||||
"url": "https://joplin.lemonlink.eu",
|
||||
"description": "Note Taking"
|
||||
}
|
||||
]
|
||||
},
|
||||
"development": {
|
||||
"title": "💻 Development",
|
||||
"apps": [
|
||||
{
|
||||
"name": "GitLab",
|
||||
"icon": "gitlab",
|
||||
"url": "https://git.lemonlink.eu",
|
||||
"description": "Git Repository"
|
||||
},
|
||||
{
|
||||
"name": "Gitea",
|
||||
"icon": "gitea",
|
||||
"url": "https://gitea.lemonlink.eu",
|
||||
"description": "Git Repository"
|
||||
},
|
||||
{
|
||||
"name": "Jenkins",
|
||||
"icon": "jenkins",
|
||||
"url": "https://jenkins.lemonlink.eu",
|
||||
"description": "CI/CD"
|
||||
},
|
||||
{
|
||||
"name": "Drone CI",
|
||||
"icon": "drone",
|
||||
"url": "https://drone.lemonlink.eu",
|
||||
"description": "CI/CD"
|
||||
},
|
||||
{
|
||||
"name": "Nexus",
|
||||
"icon": "sonatype",
|
||||
"url": "https://nexus.lemonlink.eu",
|
||||
"description": "Artifact Repository"
|
||||
},
|
||||
{
|
||||
"name": "Registry",
|
||||
"icon": "docker",
|
||||
"url": "https://registry.lemonlink.eu",
|
||||
"description": "Docker Registry"
|
||||
},
|
||||
{
|
||||
"name": "Codeserver",
|
||||
"icon": "vscode",
|
||||
"url": "https://code.lemonlink.eu",
|
||||
"description": "VS Code Server"
|
||||
}
|
||||
]
|
||||
},
|
||||
"smartHome": {
|
||||
"title": "🏠 Smart Home",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Home Assistant",
|
||||
"icon": "home-assistant",
|
||||
"url": "https://homeassistant.lemonlink.eu",
|
||||
"description": "Smart Home Hub",
|
||||
"integration": "homeassistant"
|
||||
},
|
||||
{
|
||||
"name": "Node-RED",
|
||||
"icon": "nodered",
|
||||
"url": "https://nodered.lemonlink.eu",
|
||||
"description": "Automation"
|
||||
},
|
||||
{
|
||||
"name": "ESPHome",
|
||||
"icon": "esphome",
|
||||
"url": "https://esphome.lemonlink.eu",
|
||||
"description": "ESP Devices"
|
||||
},
|
||||
{
|
||||
"name": "Zigbee2MQTT",
|
||||
"icon": "zigbee",
|
||||
"url": "https://z2m.lemonlink.eu",
|
||||
"description": "Zigbee Bridge"
|
||||
},
|
||||
{
|
||||
"name": "Scrypted",
|
||||
"icon": "scrypted",
|
||||
"url": "https://scrypted.lemonlink.eu",
|
||||
"description": "Video Integration"
|
||||
}
|
||||
]
|
||||
},
|
||||
"external": {
|
||||
"title": "🌐 External Services",
|
||||
"apps": [
|
||||
{
|
||||
"name": "Gmail",
|
||||
"icon": "gmail",
|
||||
"url": "https://mail.google.com",
|
||||
"description": "Email"
|
||||
},
|
||||
{
|
||||
"name": "Google Drive",
|
||||
"icon": "google-drive",
|
||||
"url": "https://drive.google.com",
|
||||
"description": "Cloud Storage"
|
||||
},
|
||||
{
|
||||
"name": "GitHub",
|
||||
"icon": "github",
|
||||
"url": "https://github.com",
|
||||
"description": "Code Repository"
|
||||
},
|
||||
{
|
||||
"name": "Reddit",
|
||||
"icon": "reddit",
|
||||
"url": "https://reddit.com",
|
||||
"description": "Social News"
|
||||
},
|
||||
{
|
||||
"name": "YouTube",
|
||||
"icon": "youtube",
|
||||
"url": "https://youtube.com",
|
||||
"description": "Video Platform"
|
||||
},
|
||||
{
|
||||
"name": "Twitter/X",
|
||||
"icon": "twitter",
|
||||
"url": "https://twitter.com",
|
||||
"description": "Social Media"
|
||||
},
|
||||
{
|
||||
"name": "Discord",
|
||||
"icon": "discord",
|
||||
"url": "https://discord.com",
|
||||
"description": "Chat"
|
||||
},
|
||||
{
|
||||
"name": "LinkedIn",
|
||||
"icon": "linkedin",
|
||||
"url": "https://linkedin.com",
|
||||
"description": "Professional Network"
|
||||
},
|
||||
{
|
||||
"name": "ProtonMail",
|
||||
"icon": "protonmail",
|
||||
"url": "https://mail.proton.me",
|
||||
"description": "Secure Email"
|
||||
},
|
||||
{
|
||||
"name": "Tutanota",
|
||||
"icon": "tutanota",
|
||||
"url": "https://mail.tutanota.com",
|
||||
"description": "Secure Email"
|
||||
},
|
||||
{
|
||||
"name": "Mastodon",
|
||||
"icon": "mastodon",
|
||||
"url": "https://mastodon.social",
|
||||
"description": "Fediverse"
|
||||
},
|
||||
{
|
||||
"name": "Netflix",
|
||||
"icon": "netflix",
|
||||
"url": "https://netflix.com",
|
||||
"description": "Streaming"
|
||||
},
|
||||
{
|
||||
"name": "Spotify",
|
||||
"icon": "spotify",
|
||||
"url": "https://open.spotify.com",
|
||||
"description": "Music"
|
||||
},
|
||||
{
|
||||
"name": "Amazon",
|
||||
"icon": "amazon",
|
||||
"url": "https://amazon.com",
|
||||
"description": "Shopping"
|
||||
},
|
||||
{
|
||||
"name": "Cloudflare",
|
||||
"icon": "cloudflare",
|
||||
"url": "https://dash.cloudflare.com",
|
||||
"description": "DNS/CDN"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,241 @@
|
|||
# Homarr Board Layouts
|
||||
|
||||
## Board 1: 🏠 Main Dashboard (Public)
|
||||
**Purpose**: Quick overview and commonly used links
|
||||
**Visibility**: Public (no login required)
|
||||
|
||||
### Layout Structure
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ [CLOCK & WEATHER] [SEARCH BAR] [SYSTEM STATUS OVERVIEW] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📰 NEWS & UPDATES │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ Homelab RSS │ │ Cyber RSS │ │ Tech RSS │ │
|
||||
│ │ [Widget] │ │ [Widget] │ │ [Widget] │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🔗 QUICK LINKS │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │ Gmail │ │ GitHub │ │ Reddit │ │ YouTube │ │ Discord │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🏠 INFRASTRUCTURE QUICK ACCESS │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │Proxmox │ │Portainer│ │ Plex │ │Nextcloud│ │ Vault │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Widgets
|
||||
1. **Clock** - Large, centered, with date
|
||||
2. **Weather** - Current location weather
|
||||
3. **RSS Feeds** - 3 separate widgets (Homelab, Cyber, Tech)
|
||||
4. **System Health Monitor** - Quick status from Dash.
|
||||
5. **Bookmarks** - External services
|
||||
|
||||
### Apps
|
||||
- Gmail, GitHub, Reddit, YouTube, Discord
|
||||
- Proxmox, Portainer, Plex, Nextcloud, Vaultwarden
|
||||
- Tailscale, Cloudflare
|
||||
|
||||
---
|
||||
|
||||
## Board 2: 🔧 Infrastructure (Private)
|
||||
**Purpose**: Complete infrastructure management
|
||||
**Visibility**: Private (requires login)
|
||||
|
||||
### Layout Structure
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ INFRASTRUCTURE MANAGEMENT [USER MENU] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📊 SYSTEM MONITORING (Full Dash. iFrame) │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ [Dash. WIDGET - Full Width] │ │
|
||||
│ │ CPU | RAM | STORAGE | NETWORK │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🖧 NETWORK & VIRTUALIZATION │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │Proxmox │ │ UniFi │ │OPNsense │ │Pi-hole │ │AdGuard │ │
|
||||
│ │ │ │ │ │ │ │ │ │ │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │Traefik │ │ NPM │ │WireGuard│ │Tailscale│ │ VPN │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 💾 STORAGE & BACKUP │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │TrueNAS │ │Portainer│ │ MinIO │ │Syncthing│ │
|
||||
│ │ SCALE │ │ │ │ │ │ │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📈 MONITORING STACK │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │ Grafana │ │Prometheus│ │Uptime │ │ Netdata │ │ Beszel │ │
|
||||
│ │ │ │ │ │ Kuma │ │ │ │ │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Widgets
|
||||
1. **Dash. iFrame** - Full system monitoring
|
||||
2. **DNS Hole** - Pi-hole/AdGuard stats
|
||||
3. **System Health Monitor** - Proxmox integration
|
||||
|
||||
### Apps
|
||||
All infrastructure-related apps from the apps.json configuration.
|
||||
|
||||
---
|
||||
|
||||
## Board 3: 🎬 Media Center (Private)
|
||||
**Purpose**: Media server management
|
||||
**Visibility**: Private (requires login)
|
||||
|
||||
### Layout Structure
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ MEDIA CENTER [USER MENU] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📺 MEDIA SERVERS │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │ Plex │ │Jellyfin │ │ Emby │ │
|
||||
│ │[Widget] │ │[Widget] │ │ │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🎬 ARR STACK │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │ Sonarr │ │ Radarr │ │ Lidarr │ │Readarr │ │ Bazarr │ │
|
||||
│ │ TV │ │ Movies │ │ Music │ │ Books │ │Subtitles│ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │Prowlarr │ │Overseerr│ │Jellyseer│ │
|
||||
│ │ Indexers│ │ Requests│ │ Requests│ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ⬇️ DOWNLOAD CLIENTS │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||||
│ │ qBittor-│ │Transsmis│ │ Deluge │ │ SABnzbd │ │ NZBGet │ │
|
||||
│ │ rent │ │ sion │ │ │ │ │ │ │ │
|
||||
│ │[Widget] │ │[Widget] │ │ │ │ │ │ │ │
|
||||
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Widgets
|
||||
1. **Media Server** - Active sessions from Plex/Jellyfin
|
||||
2. **Torrent** - Download progress
|
||||
3. **Usenet** - Download progress
|
||||
4. **Media Requests** - Overseerr/Jellyseerr integration
|
||||
|
||||
---
|
||||
|
||||
## Board 4: 📊 System Overview (Private)
|
||||
**Purpose**: Comprehensive system monitoring
|
||||
**Visibility**: Private (requires login)
|
||||
|
||||
### Layout Structure
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ SYSTEM OVERVIEW [USER MENU] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ [FULL SCREEN Dash. IFRAME] │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ CPU USAGE RAM USAGE STORAGE USAGE │ │
|
||||
│ │ ┌─────┐ ┌─────┐ ┌─────┐ │ │
|
||||
│ │ │ 45% │ │ 62% │ │ 78% │ │ │
|
||||
│ │ └─────┘ └─────┘ └─────┘ │ │
|
||||
│ │ │ │
|
||||
│ │ ┌─────────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ NETWORK SPEED GRAPH │ │ │
|
||||
│ │ │ [Real-time upload/download] │ │ │
|
||||
│ │ └─────────────────────────────────────────────────────┘ │ │
|
||||
│ │ │ │
|
||||
│ │ ┌─────────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ DETAILED SYSTEM INFO │ │ │
|
||||
│ │ │ OS: Ubuntu 22.04 Uptime: 45 days │ │ │
|
||||
│ │ │ CPU: Intel Xeon Cores: 24 │ │ │
|
||||
│ │ │ RAM: 96GB DDR4 Storage: 12TB │ │ │
|
||||
│ │ └─────────────────────────────────────────────────────┘ │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Board 5: 📰 News Hub (Public)
|
||||
**Purpose**: RSS feed aggregation
|
||||
**Visibility**: Public (no login required)
|
||||
|
||||
### Layout Structure
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ NEWS HUB [SEARCH] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🏠 HOMELAB NEWS │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ [RSS Widget - Selfh.st, Noted, Self-Hosted Podcast] │ │
|
||||
│ │ │ │
|
||||
│ │ • New Docker container release... [2h ago] │ │
|
||||
│ │ • How to setup Authelia with... [5h ago] │ │
|
||||
│ │ • Top 10 self-hosted apps for... [1d ago] │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🔒 CYBERSECURITY NEWS │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ [RSS Widget - Bleeping Computer, Hacker News, Krebs] │ │
|
||||
│ │ │ │
|
||||
│ │ • Critical vulnerability found in... [30m ago] │ │
|
||||
│ │ • New ransomware campaign targets... [3h ago] │ │
|
||||
│ │ • Security patch released for... [6h ago] │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 💻 TECHNOLOGY NEWS │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ │ │
|
||||
│ │ [RSS Widget - Hacker News, TechCrunch, Ars Technica] │ │
|
||||
│ │ │ │
|
||||
│ │ • New AI model released by... [1h ago] │ │
|
||||
│ │ • Tech company announces... [4h ago] │ │
|
||||
│ │ • Open source project reaches... [12h ago] │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
|
@ -0,0 +1,95 @@
|
|||
# Homarr Themes Configuration
|
||||
|
||||
## Dark Theme (Matching lemonlink.eu aesthetic)
|
||||
|
||||
### Primary Board Theme (Public)
|
||||
```json
|
||||
{
|
||||
"name": "LemonLink Dark",
|
||||
"primaryColor": "#6366f1",
|
||||
"secondaryColor": "#8b5cf6",
|
||||
"background": "#0a0a0f",
|
||||
"backgroundGradient": "linear-gradient(135deg, #0a0a0f 0%, #1a1a2e 100%)",
|
||||
"cardBackground": "rgba(255, 255, 255, 0.05)",
|
||||
"cardBorder": "rgba(255, 255, 255, 0.1)",
|
||||
"textColor": "#e2e8f0",
|
||||
"textMuted": "#94a3b8",
|
||||
"accentColor": "#fbbf24",
|
||||
"successColor": "#22c55e",
|
||||
"warningColor": "#f59e0b",
|
||||
"errorColor": "#ef4444",
|
||||
"infoColor": "#3b82f6",
|
||||
"glassEffect": true,
|
||||
"transparency": 0.8,
|
||||
"borderRadius": 16,
|
||||
"shadowIntensity": "high"
|
||||
}
|
||||
```
|
||||
|
||||
### Secondary Board Theme (Private/Admin)
|
||||
```json
|
||||
{
|
||||
"name": "LemonLink Deep",
|
||||
"primaryColor": "#06b6d4",
|
||||
"secondaryColor": "#3b82f6",
|
||||
"background": "#0f172a",
|
||||
"backgroundGradient": "linear-gradient(135deg, #0f172a 0%, #1e293b 100%)",
|
||||
"cardBackground": "rgba(15, 23, 42, 0.8)",
|
||||
"cardBorder": "rgba(6, 182, 212, 0.2)",
|
||||
"textColor": "#f1f5f9",
|
||||
"textMuted": "#64748b",
|
||||
"accentColor": "#22d3ee",
|
||||
"glassEffect": true,
|
||||
"transparency": 0.9,
|
||||
"borderRadius": 12
|
||||
}
|
||||
```
|
||||
|
||||
## Custom CSS for Advanced Styling
|
||||
|
||||
```css
|
||||
/* Glassmorphism Cards */
|
||||
.homarr-card {
|
||||
background: rgba(255, 255, 255, 0.05) !important;
|
||||
backdrop-filter: blur(10px) !important;
|
||||
border: 1px solid rgba(255, 255, 255, 0.1) !important;
|
||||
border-radius: 16px !important;
|
||||
transition: all 0.3s ease !important;
|
||||
}
|
||||
|
||||
.homarr-card:hover {
|
||||
transform: translateY(-4px) !important;
|
||||
box-shadow: 0 20px 40px rgba(0, 0, 0, 0.3) !important;
|
||||
border-color: rgba(99, 102, 241, 0.3) !important;
|
||||
}
|
||||
|
||||
/* Animated Gradient Background */
|
||||
.dashboard-background {
|
||||
background: linear-gradient(-45deg, #0a0a0f, #1a1a2e, #0f172a, #1e1b4b);
|
||||
background-size: 400% 400%;
|
||||
animation: gradient 15s ease infinite;
|
||||
}
|
||||
|
||||
@keyframes gradient {
|
||||
0% { background-position: 0% 50%; }
|
||||
50% { background-position: 100% 50%; }
|
||||
100% { background-position: 0% 50%; }
|
||||
}
|
||||
|
||||
/* Glowing Text Effect */
|
||||
.glow-text {
|
||||
text-shadow: 0 0 20px rgba(99, 102, 241, 0.5);
|
||||
}
|
||||
|
||||
/* Custom Scrollbar */
|
||||
::-webkit-scrollbar {
|
||||
width: 8px;
|
||||
}
|
||||
::-webkit-scrollbar-track {
|
||||
background: rgba(0, 0, 0, 0.2);
|
||||
}
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: rgba(99, 102, 241, 0.5);
|
||||
border-radius: 4px;
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,194 @@
|
|||
{
|
||||
"description": "Curated RSS feeds for Homarr dashboard",
|
||||
"categories": {
|
||||
"homelab": {
|
||||
"title": "Homelab & Self-Hosted",
|
||||
"feeds": [
|
||||
{
|
||||
"name": "Selfh.st",
|
||||
"url": "https://selfh.st/rss/",
|
||||
"description": "Self-hosted software directory and news"
|
||||
},
|
||||
{
|
||||
"name": "Noted",
|
||||
"url": "https://noted.lol/rss/",
|
||||
"description": "Self-hosting guides and tutorials"
|
||||
},
|
||||
{
|
||||
"name": "Techno Tim",
|
||||
"url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCOk-gHyjcWZNj3Br4oxwh0A",
|
||||
"description": "Homelab tutorials and projects"
|
||||
},
|
||||
{
|
||||
"name": "Self-Hosted Podcast",
|
||||
"url": "https://feeds.fireside.fm/selfhosted/rss",
|
||||
"description": "Jupiter Broadcasting homelab podcast"
|
||||
},
|
||||
{
|
||||
"name": "r/SelfHosted",
|
||||
"url": "https://www.reddit.com/r/selfhosted.rss",
|
||||
"description": "Self-hosted community discussions"
|
||||
},
|
||||
{
|
||||
"name": "Awesome Selfhosted",
|
||||
"url": "https://github.com/awesome-selfhosted/awesome-selfhosted/releases.atom",
|
||||
"description": "Awesome self-hosted software list updates"
|
||||
}
|
||||
]
|
||||
},
|
||||
"cybersecurity": {
|
||||
"title": "Cybersecurity",
|
||||
"feeds": [
|
||||
{
|
||||
"name": "Bleeping Computer",
|
||||
"url": "https://www.bleepingcomputer.com/feed/",
|
||||
"description": "Cybersecurity news and alerts"
|
||||
},
|
||||
{
|
||||
"name": "The Hacker News",
|
||||
"url": "https://feeds.feedburner.com/TheHackersNews",
|
||||
"description": "Cybersecurity and hacking news"
|
||||
},
|
||||
{
|
||||
"name": "Krebs on Security",
|
||||
"url": "https://krebsonsecurity.com/feed/",
|
||||
"description": "Brian Krebs security blog"
|
||||
},
|
||||
{
|
||||
"name": "Dark Reading",
|
||||
"url": "https://www.darkreading.com/rss.xml",
|
||||
"description": "Enterprise security news"
|
||||
},
|
||||
{
|
||||
"name": "Schneier on Security",
|
||||
"url": "https://www.schneier.com/feed/atom/",
|
||||
"description": "Bruce Schneier security blog"
|
||||
},
|
||||
{
|
||||
"name": "NIST NVD",
|
||||
"url": "https://nvd.nist.gov/feeds/xml/cve/misc/nvd-rss.xml",
|
||||
"description": "Latest CVE vulnerabilities"
|
||||
}
|
||||
]
|
||||
},
|
||||
"technology": {
|
||||
"title": "Technology & Dev",
|
||||
"feeds": [
|
||||
{
|
||||
"name": "Hacker News",
|
||||
"url": "https://news.ycombinator.com/rss",
|
||||
"description": "Tech news and discussions"
|
||||
},
|
||||
{
|
||||
"name": "TechCrunch",
|
||||
"url": "https://techcrunch.com/feed/",
|
||||
"description": "Startup and technology news"
|
||||
},
|
||||
{
|
||||
"name": "Ars Technica",
|
||||
"url": "https://feeds.arstechnica.com/arstechnica/index",
|
||||
"description": "Technology news and reviews"
|
||||
},
|
||||
{
|
||||
"name": "Wired",
|
||||
"url": "https://www.wired.com/feed/rss",
|
||||
"description": "Technology and culture"
|
||||
},
|
||||
{
|
||||
"name": "The Verge",
|
||||
"url": "https://www.theverge.com/rss/index.xml",
|
||||
"description": "Technology and consumer electronics"
|
||||
},
|
||||
{
|
||||
"name": "GitHub Trending",
|
||||
"url": "https://github.com/trending/feed",
|
||||
"description": "Trending repositories"
|
||||
},
|
||||
{
|
||||
"name": "Dev.to",
|
||||
"url": "https://dev.to/feed",
|
||||
"description": "Developer community articles"
|
||||
}
|
||||
]
|
||||
},
|
||||
"linux": {
|
||||
"title": "Linux & Open Source",
|
||||
"feeds": [
|
||||
{
|
||||
"name": "Phoronix",
|
||||
"url": "https://www.phoronix.com/rss.php",
|
||||
"description": "Linux hardware and benchmarking"
|
||||
},
|
||||
{
|
||||
"name": "LWN.net",
|
||||
"url": "https://lwn.net/headlines/rss",
|
||||
"description": "Linux weekly news"
|
||||
},
|
||||
{
|
||||
"name": "OMG! Ubuntu",
|
||||
"url": "https://www.omgubuntu.co.uk/feed",
|
||||
"description": "Ubuntu and Linux news"
|
||||
},
|
||||
{
|
||||
"name": "Arch Linux News",
|
||||
"url": "https://archlinux.org/feeds/news/",
|
||||
"description": "Arch Linux announcements"
|
||||
},
|
||||
{
|
||||
"name": "Proxmox Blog",
|
||||
"url": "https://www.proxmox.com/en/news/rss",
|
||||
"description": "Proxmox virtualization news"
|
||||
}
|
||||
]
|
||||
},
|
||||
"docker": {
|
||||
"title": "Docker & Containers",
|
||||
"feeds": [
|
||||
{
|
||||
"name": "Docker Blog",
|
||||
"url": "https://www.docker.com/feed/",
|
||||
"description": "Official Docker blog"
|
||||
},
|
||||
{
|
||||
"name": "LinuxServer.io",
|
||||
"url": "https://blog.linuxserver.io/rss/",
|
||||
"description": "Container images and guides"
|
||||
},
|
||||
{
|
||||
"name": "Kubernetes Blog",
|
||||
"url": "https://kubernetes.io/feed.xml",
|
||||
"description": "Kubernetes official blog"
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"widgetConfig": {
|
||||
"homelabRss": {
|
||||
"feedUrls": [
|
||||
"https://selfh.st/rss/",
|
||||
"https://noted.lol/rss/",
|
||||
"https://feeds.fireside.fm/selfhosted/rss"
|
||||
],
|
||||
"postsLimit": 20,
|
||||
"descriptionLineClamp": 3
|
||||
},
|
||||
"cyberRss": {
|
||||
"feedUrls": [
|
||||
"https://www.bleepingcomputer.com/feed/",
|
||||
"https://feeds.feedburner.com/TheHackersNews",
|
||||
"https://krebsonsecurity.com/feed/"
|
||||
],
|
||||
"postsLimit": 20,
|
||||
"descriptionLineClamp": 2
|
||||
},
|
||||
"techRss": {
|
||||
"feedUrls": [
|
||||
"https://news.ycombinator.com/rss",
|
||||
"https://techcrunch.com/feed/",
|
||||
"https://feeds.arstechnica.com/arstechnica/index"
|
||||
],
|
||||
"postsLimit": 20,
|
||||
"descriptionLineClamp": 3
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,110 @@
|
|||
#!/bin/bash
|
||||
#======================================================================#
|
||||
# Homarr Quick Deployment Script #
|
||||
#======================================================================#
|
||||
|
||||
set -e
|
||||
|
||||
# Colors
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
echo -e "${BLUE}========================================${NC}"
|
||||
echo -e "${BLUE} Homarr Dashboard Deployment Script ${NC}"
|
||||
echo -e "${BLUE}========================================${NC}"
|
||||
echo ""
|
||||
|
||||
# Check if running as root
|
||||
if [ "$EUID" -eq 0 ]; then
|
||||
echo -e "${YELLOW}⚠️ Warning: Running as root. Continuing...${NC}"
|
||||
fi
|
||||
|
||||
# Check Docker
|
||||
if ! command -v docker &> /dev/null; then
|
||||
echo -e "${RED}❌ Docker is not installed!${NC}"
|
||||
echo "Install Docker first: https://docs.docker.com/get-docker/"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
|
||||
echo -e "${RED}❌ Docker Compose is not installed!${NC}"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo -e "${GREEN}✅ Docker is installed${NC}"
|
||||
|
||||
# Generate encryption key
|
||||
echo ""
|
||||
echo -e "${BLUE}🔐 Generating encryption key...${NC}"
|
||||
if command -v openssl &> /dev/null; then
|
||||
ENCRYPTION_KEY=$(openssl rand -hex 32)
|
||||
else
|
||||
ENCRYPTION_KEY=$(head -c 32 /dev/urandom | xxd -p | tr -d '\n')
|
||||
fi
|
||||
echo -e "${GREEN}✅ Encryption key generated${NC}"
|
||||
|
||||
# Setup environment file
|
||||
if [ ! -f .env ]; then
|
||||
echo ""
|
||||
echo -e "${BLUE}📄 Creating .env file...${NC}"
|
||||
cp .env.example .env
|
||||
sed -i "s/SECRET_ENCRYPTION_KEY=.*/SECRET_ENCRYPTION_KEY=$ENCRYPTION_KEY/" .env
|
||||
echo -e "${GREEN}✅ .env file created${NC}"
|
||||
echo -e "${YELLOW}⚠️ Please edit .env with your domain and settings${NC}"
|
||||
else
|
||||
echo -e "${YELLOW}⚠️ .env file already exists, skipping...${NC}"
|
||||
fi
|
||||
|
||||
# Create directories
|
||||
echo ""
|
||||
echo -e "${BLUE}📁 Creating directories...${NC}"
|
||||
mkdir -p homarr/appdata dash traefik/letsencrypt
|
||||
echo -e "${GREEN}✅ Directories created${NC}"
|
||||
|
||||
# Start services
|
||||
echo ""
|
||||
echo -e "${BLUE}🚀 Starting services...${NC}"
|
||||
if docker compose version &> /dev/null; then
|
||||
docker compose up -d
|
||||
else
|
||||
docker-compose up -d
|
||||
fi
|
||||
echo -e "${GREEN}✅ Services started${NC}"
|
||||
|
||||
# Wait for services
|
||||
echo ""
|
||||
echo -e "${BLUE}⏳ Waiting for services to be ready...${NC}"
|
||||
sleep 5
|
||||
|
||||
# Check status
|
||||
echo ""
|
||||
echo -e "${BLUE}📊 Service Status:${NC}"
|
||||
if docker compose version &> /dev/null; then
|
||||
docker compose ps
|
||||
else
|
||||
docker-compose ps
|
||||
fi
|
||||
|
||||
# Get IP
|
||||
IP=$(hostname -I | awk '{print $1}')
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}========================================${NC}"
|
||||
echo -e "${GREEN} 🎉 Deployment Complete! ${NC}"
|
||||
echo -e "${GREEN}========================================${NC}"
|
||||
echo ""
|
||||
echo -e "Access your dashboard at:"
|
||||
echo -e " ${BLUE}• Homarr:${NC} http://$IP:7575"
|
||||
echo -e " ${BLUE}• Dash.:${NC} http://$IP:3001"
|
||||
echo -e " ${BLUE}• Traefik:${NC} http://$IP:8080"
|
||||
echo ""
|
||||
echo -e "${YELLOW}Next Steps:${NC}"
|
||||
echo -e " 1. Complete the onboarding at http://$IP:7575"
|
||||
echo -e " 2. Create your first board"
|
||||
echo -e " 3. Configure your apps and widgets"
|
||||
echo -e " 4. See DEPLOYMENT.md for detailed configuration"
|
||||
echo ""
|
||||
echo -e "${GREEN}Happy Homelabbing! 🏠${NC}"
|
||||
|
|
@ -0,0 +1,88 @@
|
|||
#======================================================================#
|
||||
# Homarr + Dash. - Ultimate Homelab Dashboard Stack #
|
||||
# Designed for Nginx Proxy Manager (NPM) #
|
||||
# Repo: gitea.lemonlink.eu/homelab/homarr-dashboard #
|
||||
#======================================================================#
|
||||
|
||||
services:
|
||||
#------------------------------------------------------------------#
|
||||
# Homarr 1.0 - Modern Dashboard #
|
||||
#------------------------------------------------------------------#
|
||||
homarr:
|
||||
container_name: homarr
|
||||
image: ghcr.io/homarr-labs/homarr:beta
|
||||
restart: unless-stopped
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
- ./homarr/appdata:/appdata
|
||||
environment:
|
||||
# Generate with: openssl rand -hex 32
|
||||
- SECRET_ENCRYPTION_KEY=${SECRET_ENCRYPTION_KEY}
|
||||
# Database configuration (SQLite default)
|
||||
- DB_URL=/appdata/db/homarr.db
|
||||
# Authentication settings
|
||||
- AUTH_PROVIDERS=${AUTH_PROVIDERS:-credentials}
|
||||
# Logging
|
||||
- NODE_ENV=production
|
||||
ports:
|
||||
- '${HOMARR_PORT:-7575}:7575'
|
||||
networks:
|
||||
- dashboard-network
|
||||
- npm-network # Connect to NPM network for reverse proxy
|
||||
depends_on:
|
||||
- dash
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Dash. - System Monitoring #
|
||||
#------------------------------------------------------------------#
|
||||
dash:
|
||||
container_name: dash
|
||||
image: mauricenino/dashdot:latest
|
||||
restart: unless-stopped
|
||||
privileged: true
|
||||
volumes:
|
||||
- /:/mnt/host:ro
|
||||
environment:
|
||||
# Widget customization
|
||||
- DASHDOT_ENABLE_CPU_TEMPS=true
|
||||
- DASHDOT_ALWAYS_SHOW_PERCENTAGES=true
|
||||
- DASHDOT_ENABLE_STORAGE_SPLIT_VIEW=true
|
||||
- DASHDOT_PAGE_TITLE=System Overview
|
||||
# Network speed test (every 4 hours)
|
||||
- DASHDOT_SPEED_TEST_INTERVAL=${DASH_SPEED_TEST_INTERVAL:-240}
|
||||
# Theme - dark to match lemonlink.eu
|
||||
- DASHDOT_WIDGET_LIST=os,cpu,storage,ram,network
|
||||
- DASHDOT_OS_LABEL_LIST=brand,os,arch,up_since
|
||||
- DASHDOT_CPU_LABEL_LIST=brand,model,cores,threads,frequency
|
||||
- DASHDOT_STORAGE_LABEL_LIST=brand,size,type
|
||||
- DASHDOT_RAM_LABEL_LIST=brand,size,type,frequency
|
||||
- DASHDOT_NETWORK_LABEL_LIST=type,speed_up,speed_down,interface_speed
|
||||
ports:
|
||||
- '${DASH_PORT:-3001}:3001'
|
||||
networks:
|
||||
- dashboard-network
|
||||
- npm-network # Connect to NPM network for reverse proxy
|
||||
|
||||
#------------------------------------------------------------------#
|
||||
# Watchtower - Auto-update containers #
|
||||
#------------------------------------------------------------------#
|
||||
watchtower:
|
||||
container_name: watchtower
|
||||
image: containrrr/watchtower:latest
|
||||
restart: unless-stopped
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
environment:
|
||||
- WATCHTOWER_CLEANUP=true
|
||||
- WATCHTOWER_POLL_INTERVAL=${WATCHTOWER_INTERVAL:-86400}
|
||||
- WATCHTOWER_INCLUDE_STOPPED=true
|
||||
- WATCHTOWER_NOTIFICATIONS=${WATCHTOWER_NOTIFICATIONS:-}
|
||||
command: --interval ${WATCHTOWER_INTERVAL:-86400} homarr dash
|
||||
networks:
|
||||
- dashboard-network
|
||||
|
||||
networks:
|
||||
dashboard-network:
|
||||
driver: bridge
|
||||
npm-network:
|
||||
external: true # Created by NPM
|
||||
|
|
@ -0,0 +1,194 @@
|
|||
#!/bin/bash
|
||||
#======================================================================#
|
||||
# Homarr Update Script #
|
||||
# Pulls latest changes from Gitea and restarts services #
|
||||
#======================================================================#
|
||||
|
||||
set -e
|
||||
|
||||
# Colors
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
REPO_URL="https://gitea.lemonlink.eu/homelab/homarr-dashboard"
|
||||
|
||||
print_header() {
|
||||
echo -e "${BLUE}========================================${NC}"
|
||||
echo -e "${BLUE} Homarr Dashboard Update Script ${NC}"
|
||||
echo -e "${BLUE}========================================${NC}"
|
||||
echo ""
|
||||
}
|
||||
|
||||
print_success() {
|
||||
echo -e "${GREEN}✅ $1${NC}"
|
||||
}
|
||||
|
||||
print_warning() {
|
||||
echo -e "${YELLOW}⚠️ $1${NC}"
|
||||
}
|
||||
|
||||
print_error() {
|
||||
echo -e "${RED}❌ $1${NC}"
|
||||
}
|
||||
|
||||
print_info() {
|
||||
echo -e "${BLUE}ℹ️ $1${NC}"
|
||||
}
|
||||
|
||||
# Check if running in git repo
|
||||
check_git_repo() {
|
||||
if [ ! -d .git ]; then
|
||||
print_error "Not a git repository!"
|
||||
print_info "Please run this script from the homarr-dashboard directory"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Backup current state
|
||||
backup_data() {
|
||||
print_info "Creating backup..."
|
||||
BACKUP_DIR="backups/$(date +%Y%m%d_%H%M%S)"
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
|
||||
if [ -d "homarr/appdata" ]; then
|
||||
cp -r homarr/appdata "$BACKUP_DIR/" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
if [ -f ".env" ]; then
|
||||
cp .env "$BACKUP_DIR/" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
print_success "Backup created at $BACKUP_DIR"
|
||||
}
|
||||
|
||||
# Pull latest changes
|
||||
pull_updates() {
|
||||
print_info "Pulling latest changes from Gitea..."
|
||||
|
||||
# Fetch latest changes
|
||||
git fetch origin
|
||||
|
||||
# Check if there are updates
|
||||
LOCAL=$(git rev-parse HEAD)
|
||||
REMOTE=$(git rev-parse origin/main 2>/dev/null || git rev-parse origin/master)
|
||||
|
||||
if [ "$LOCAL" = "$REMOTE" ]; then
|
||||
print_success "Already up to date!"
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Stash local changes if any
|
||||
if ! git diff-index --quiet HEAD --; then
|
||||
print_warning "Local changes detected, stashing..."
|
||||
git stash
|
||||
fi
|
||||
|
||||
# Pull updates
|
||||
git pull origin main 2>/dev/null || git pull origin master
|
||||
print_success "Updated to latest version"
|
||||
|
||||
# Show changes
|
||||
echo ""
|
||||
print_info "Recent changes:"
|
||||
git log --oneline -5
|
||||
}
|
||||
|
||||
# Update Docker images
|
||||
update_containers() {
|
||||
echo ""
|
||||
print_info "Pulling latest Docker images..."
|
||||
docker compose pull
|
||||
print_success "Docker images updated"
|
||||
}
|
||||
|
||||
# Restart services
|
||||
restart_services() {
|
||||
echo ""
|
||||
print_info "Restarting services..."
|
||||
docker compose up -d --remove-orphans
|
||||
print_success "Services restarted"
|
||||
}
|
||||
|
||||
# Cleanup old images
|
||||
cleanup() {
|
||||
echo ""
|
||||
print_info "Cleaning up old Docker images..."
|
||||
docker image prune -f
|
||||
print_success "Cleanup complete"
|
||||
}
|
||||
|
||||
# Check service status
|
||||
check_status() {
|
||||
echo ""
|
||||
print_info "Service Status:"
|
||||
echo "----------------------------------------"
|
||||
docker compose ps
|
||||
echo "----------------------------------------"
|
||||
|
||||
# Check if services are healthy
|
||||
if docker compose ps | grep -q "Up"; then
|
||||
echo ""
|
||||
print_success "All services are running!"
|
||||
|
||||
# Get IP for access info
|
||||
IP=$(hostname -I | awk '{print $1}')
|
||||
echo ""
|
||||
echo -e "${GREEN}Access your dashboard:${NC}"
|
||||
echo -e " • Homarr: http://$IP:7575"
|
||||
echo -e " • Dash.: http://$IP:3001"
|
||||
else
|
||||
echo ""
|
||||
print_error "Some services are not running!"
|
||||
print_info "Check logs with: docker compose logs"
|
||||
fi
|
||||
}
|
||||
|
||||
# Main function
|
||||
main() {
|
||||
print_header
|
||||
|
||||
# Check prerequisites
|
||||
if ! command -v docker &> /dev/null; then
|
||||
print_error "Docker not found!"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! command -v git &> /dev/null; then
|
||||
print_error "Git not found!"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
check_git_repo
|
||||
|
||||
# Show current version
|
||||
CURRENT_COMMIT=$(git rev-parse --short HEAD)
|
||||
print_info "Current version: $CURRENT_COMMIT"
|
||||
|
||||
# Confirm update
|
||||
read -p "Proceed with update? (y/N): " -n 1 -r
|
||||
echo ""
|
||||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||||
print_info "Update cancelled"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Execute update steps
|
||||
backup_data
|
||||
pull_updates
|
||||
update_containers
|
||||
restart_services
|
||||
cleanup
|
||||
check_status
|
||||
|
||||
echo ""
|
||||
print_success "Update complete! 🎉"
|
||||
echo ""
|
||||
print_info "If you encounter issues, restore from backup:"
|
||||
echo " cp -r backups/$(ls -t backups | head -1)/* ."
|
||||
}
|
||||
|
||||
# Run main function
|
||||
main
|
||||
Loading…
Reference in New Issue