# ⚡ Quick Configuration Guide

Your Homarr is running! Let's set it up in ~10 minutes.

---

## 1️⃣ Initial Setup

### Access Onboarding
- Open: `http://YOUR-SERVER-IP:7575`
- Create admin account (this user has full control)
- Complete the onboarding wizard

---

## 2️⃣ Create Boards

Go to **Manage → Boards → New Board**

### Board 1: Main Dashboard (Public)
```
Name: Main Dashboard
Visibility: Public (accessible without login)
```

**Add Widgets:**
1. **Clock** → Large, show date
2. **Weather** → Enter your location
3. **RSS Feed** (Homelab):
   - Name: "Homelab News"
   - URLs: `https://selfh.st/rss/,https://noted.lol/rss/`
   - Posts limit: 10
4. **RSS Feed** (Cyber):
   - Name: "Cybersecurity"
   - URLs: `https://www.bleepingcomputer.com/feed/,https://krebsonsecurity.com/feed/`
5. **RSS Feed** (Tech):
   - Name: "Tech News"
   - URLs: `https://news.ycombinator.com/rss,https://techcrunch.com/feed/`

**Add Apps:**
- Gmail, GitHub, Reddit, YouTube
- Proxmox, Portainer, Plex

### Board 2: Infrastructure (Private)
```
Name: Infrastructure
Visibility: Private (login required)
```

**Add Widgets:**
1. **iFrame** → URL: `http://YOUR-SERVER-IP:3001` (full width)
2. **System Health Monitor** (if you have Proxmox)
3. **DNS Hole** (if you have Pi-hole/AdGuard)

**Add Apps:**
- Proxmox, Portainer, TrueNAS
- Grafana, Uptime Kuma
- Pi-hole, AdGuard

### Board 3: System Overview (Private)
```
Name: System
Visibility: Private
Layout: Full width
```

**Add Widget:**
1. **iFrame** → `http://YOUR-SERVER-IP:3001` (fullscreen)

---

## 3️⃣ Add Apps (Quick Method)

Go to **Manage → Apps → New App**

### Example Apps to Add:

| Name | Icon | URL |
|------|------|-----|
| Proxmox | `proxmox` | `https://proxmox.lemonlink.eu` |
| Portainer | `portainer` | `https://portainer.lemonlink.eu` |
| Plex | `plex` | `https://plex.lemonlink.eu` |
| Nextcloud | `nextcloud` | `https://cloud.lemonlink.eu` |
| GitHub | `github` | `https://github.com` |
| Reddit | `reddit` | `https://reddit.com` |

**Tip:** Type icon name in the icon field - Homarr has 11,000+ icons!

---

## 4️⃣ Theme Customization

Go to **Board Settings → Appearance**

### Dark Theme (lemonlink.eu style):
```
Primary Color: #6366f1 (Indigo)
Secondary Color: #8b5cf6 (Purple)
Background: #0a0a0f (Near black)
Text Color: #e2e8f0
```

### Custom CSS (Board Settings):
```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;
}

.homarr-card:hover {
  transform: translateY(-4px) !important;
  box-shadow: 0 20px 40px rgba(0, 0, 0, 0.3) !important;
}
```

---

## 5️⃣ Integrations

Go to **Manage → Integrations**

### Dash. (System Monitor)
Already integrated! Just add iFrame widget with `http://YOUR-SERVER-IP:3001`

### Docker
1. Click **New Integration**
2. Type: Docker
3. Name: "Local Docker"
4. Save

### Proxmox (Optional)
1. New Integration → Proxmox
2. Host: `https://proxmox.lemonlink.eu`
3. Token ID & Secret from Proxmox
4. Save

### Media Servers (Optional)
1. New Integration → Plex/Jellyfin
2. Enter API key/URL
3. Test connection
4. Save

---

## 6️⃣ Access Control

### Public vs Private

| Board | Visibility | Who Can See |
|-------|------------|-------------|
| Main Dashboard | Public | Everyone |
| News Hub | Public | Everyone |
| Infrastructure | Private | Logged-in users |
| Media Center | Private | Logged-in users |
| System | Private | Logged-in users |

Change visibility: **Board Settings → Visibility**

---

## 7️⃣ RSS Feed URLs

From `config/rss-feeds.json`:

### Homelab
```
https://selfh.st/rss/
https://noted.lol/rss/
https://feeds.fireside.fm/selfhosted/rss
```

### Cybersecurity
```
https://www.bleepingcomputer.com/feed/
https://feeds.feedburner.com/TheHackersNews
https://krebsonsecurity.com/feed/
```

### Technology
```
https://news.ycombinator.com/rss
https://techcrunch.com/feed/
https://feeds.arstechnica.com/arstechnica/index
```

---

## ✅ Quick Checklist

- [ ] Create admin account
- [ ] Create 3-5 boards
- [ ] Add 10-20 apps
- [ ] Add Clock + Weather widgets
- [ ] Add 3 RSS feed widgets
- [ ] Add Dash. iFrame to infrastructure board
- [ ] Set dark theme colors
- [ ] Configure public/private boards
- [ ] Test external access via NPM

---

## 🎯 Pro Tips

1. **Drag & Drop**: Move apps/widgets by dragging
2. **Resize**: Use corner handles on widgets
3. **Search**: Use the search bar for quick access
4. **Edit Mode**: Click pencil icon to edit board
5. **Icons**: Type app name in icon field - auto-suggests

---

## 🆘 Need Help?

- **Homarr Docs**: https://homarr.dev/docs/
- **Your Repo**: https://git.lemonlink.eu/impulsivefps/homarr-dashboard