homarr-dashboard/IMPORT_JSON.md

📥 Import JSON Boards into Homarr

Step-by-Step Import Guide

Step 1: Download the JSON Files

From your Gitea repo:

https://git.lemonlink.eu/impulsivefps/homarr-dashboard/tree/main/boards

Download these files:

• main-dashboard.json
• system-overview.json
• infrastructure.json

Step 2: Get the Files to Your Server

Option A - Download directly on server:

cd /tmp
wget https://git.lemonlink.eu/impulsivefps/homarr-dashboard/raw/main/boards/main-dashboard.json
wget https://git.lemonlink.eu/impulsivefps/homarr-dashboard/raw/main/boards/system-overview.json
wget https://git.lemonlink.eu/impulsivefps/homarr-dashboard/raw/main/boards/infrastructure.json

Option B - Clone the repo:

git clone https://git.lemonlink.eu/impulsivefps/homarr-dashboard.git
cd homarr-dashboard/boards

Step 3: Import Each Board

Import Main Dashboard

# Copy JSON into Homarr container
docker cp /tmp/main-dashboard.json homarr:/tmp/

# Access Homarr container
docker exec -it homarr sh

# The board data needs to be inserted via the Homarr API
# Exit container for now
exit

Alternative: Use Homarr's Web UI

Unfortunately, Homarr 1.0 doesn't have a direct JSON import in the UI yet.

You'll need to manually create the boards using the JSON as reference.

---

🛠️ Manual Import (Current Method)

Since Homarr 1.0 doesn't have JSON import yet, do this:

Create Main Dashboard Manually

1. Create Board:

   Profile → Manage → Boards → New Board
   Name: Main Dashboard
   Visibility: Public
   

2. Add Apps First:

   Manage → Apps → New App
   
   App 1:
   - Name: Gmail
   - Icon: gmail
   - URL: https://mail.google.com
   
   App 2:
   - Name: GitHub
   - Icon: github
   - URL: https://github.com
   
   App 3:
   - Name: Reddit
   - Icon: reddit
   - URL: https://reddit.com
   
   App 4:
   - Name: YouTube
   - Icon: youtube
   - URL: https://youtube.com
   
   App 5:
   - Name: Discord
   - Icon: discord
   - URL: https://discord.com
   
   App 6:
   - Name: Proxmox
   - Icon: proxmox
   - URL: https://proxmox.lemonlink.eu
   
   App 7:
   - Name: Portainer
   - Icon: portainer
   - URL: https://portainer.lemonlink.eu
   
   App 8:
   - Name: Plex
   - Icon: plex
   - URL: https://plex.lemonlink.eu
   
   App 9:
   - Name: Nextcloud
   - Icon: nextcloud
   - URL: https://cloud.lemonlink.eu
   
   App 10:
   - Name: Vaultwarden
   - Icon: vaultwarden
   - URL: https://vault.lemonlink.eu
   

3. Add Widgets to Board:

   Open Main Dashboard → Edit Mode (pencil icon)
   
   Widget 1 - Clock:
   - Add Item → Clock
   - Settings: Show date ✅, 24h format
   - Position: Top left
   - Size: 2x2
   
   Widget 2 - Weather:
   - Add Item → Weather
   - Location: Stockholm, Sweden (change to yours)
   - Position: Next to clock
   - Size: 2x2
   
   Widget 3 - RSS Homelab:
   - Add Item → RSS Feed
   - Name: Homelab News
   - URLs:
     https://selfh.st/rss/
     https://noted.lol/rss/
     https://feeds.fireside.fm/selfhosted/rss
   - Posts limit: 10
   - Size: 3x4
   
   Widget 4 - RSS Cyber:
   - Add Item → RSS Feed
   - Name: Cybersecurity
   - URLs:
     https://www.bleepingcomputer.com/feed/
     https://feeds.feedburner.com/TheHackersNews
     https://krebsonsecurity.com/feed/
   - Posts limit: 10
   - Size: 3x4
   
   Widget 5 - RSS Tech:
   - Add Item → RSS Feed
   - Name: Tech News
   - URLs:
     https://news.ycombinator.com/rss
     https://techcrunch.com/feed/
   - Posts limit: 8
   - Hide description ✅
   - Size: 2x4
   

4. Add Apps to Board:

   Add Item → App → Select each app you created
   Arrange them in a row at the bottom
   

5. Apply Theme:

   Settings (gear icon) → Appearance
   
   Primary Color: #6366f1
   Secondary Color: #8b5cf6
   Background: #0a0a0f
   Text Color: #e2e8f0
   
   Custom CSS: Copy from config/custom-boards.css
   

Create System Overview Board

1. New Board
   Name: System Overview
   Visibility: Private

2. Add Widget
   Type: iFrame
   Name: System Monitor
   URL: http://YOUR-SERVER-IP:3001
   Size: Full width (as large as possible)

3. Save

Create Infrastructure Board

1. New Board
   Name: Infrastructure
   Visibility: Private

2. Add Apps (create these first in Manage → Apps):
   - Proxmox, Portainer, TrueNAS
   - Pi-hole, AdGuard, NPM, UniFi
   - Tailscale, Grafana, Prometheus
   - Uptime Kuma, Netdata, WireGuard

3. Arrange them on the board

---

🚀 Quick Alternative

Since manual import is tedious, would you like me to:

Option A: Create a script that auto-creates these via API?

Option B: Give you copy-paste commands for every single field?

Option C: Create SQL insert statements to directly populate the database?

The SQL method would be fastest - one command and all boards are ready!

---

Need Help?

If you get stuck on any step, tell me which one and I'll help! 🚀