Initial commit: ATLAS Dashboard (Next.js)

2026-03-01 12:10:20 -05:00 · 2026-02-13 12:24:02 -05:00
commit d6debe51b1
72 changed files with 16965 additions and 0 deletions
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -0,0 +1,152 @@
+# Quick Start Guide - Atlas Dashboard Deployment
+
+## 🚀 5-Minute Deploy
+
+### Step 1: Configure Environment (2 minutes)
+
+Create `.env.local` on the Atlas server:
+
+```bash
+ssh soadmin@100.104.196.38
+
+cat > /opt/dashboard/.env.local << 'EOF'
+# Docker API
+DOCKER_HOST=http://100.104.196.38:2375
+
+# UniFi Controller
+UNIFI_HOST=100.104.196.38
+UNIFI_PORT=8443
+UNIFI_USERNAME=admin
+UNIFI_PASSWORD=YOUR_PASSWORD
+
+# Synology NAS
+SYNOLOGY_HOST=100.104.196.38
+SYNOLOGY_PORT=5001
+SYNOLOGY_USERNAME=admin
+SYNOLOGY_PASSWORD=YOUR_PASSWORD
+
+# Grafana
+NEXT_PUBLIC_GRAFANA_HOST=http://100.104.196.38:3000
+GRAFANA_API_KEY=your_api_key_here
+
+# API Configuration
+NEXT_PUBLIC_API_BASE_URL=http://100.104.196.38:3001
+EOF
+```
+
+### Step 2: Deploy (2 minutes)
+
+```bash
+cd /opt/dashboard
+
+# Clone if first time
+git clone https://github.com/mblanke/Dashboard.git .
+# or update existing
+git pull origin main
+
+# Deploy
+docker-compose build
+docker-compose up -d
+```
+
+### Step 3: Verify (1 minute)
+
+```bash
+# Check status
+docker-compose ps
+
+# View logs
+docker-compose logs dashboard
+
+# Test access
+curl http://localhost:3001
+```
+
+**Access dashboard**: `http://100.104.196.38:3001`
+
+---
+
+## 🔧 Automated Deploy Script
+
+### Linux/Mac:
+
+```bash
+chmod +x deploy.sh
+./deploy.sh
+```
+
+### Windows:
+
+```cmd
+deploy.bat
+```
+
+---
+
+## 📊 What You'll See
+
+Once deployed, the dashboard shows:
+
+1. **Docker Containers** - Grouped by category (Media, Download, Infrastructure, Monitoring, Automation, etc.)
+2. **UniFi Network** - Connected devices and client count
+3. **Synology Storage** - Volume usage and capacity
+4. **Grafana Panels** - Embedded monitoring dashboards
+
+---
+
+## 🆘 Troubleshooting
+
+**Dashboard not accessible?**
+```bash
+ssh soadmin@100.104.196.38
+docker-compose -C /opt/dashboard logs
+```
+
+**Container won't start?**
+- Check `.env.local` has all required variables
+- Verify Docker daemon is running: `docker ps`
+- Check firewall allows port 3001
+
+**Widgets show errors?**
+- Verify credentials in `.env.local`
+- Check external service is accessible from Atlas server
+- View browser console for more details
+
+---
+
+## 🔄 Updates
+
+Pull latest changes and redeploy:
+
+```bash
+cd /opt/dashboard
+git pull origin main
+docker-compose build
+docker-compose up -d
+```
+
+---
+
+## 📝 Environment Variables
+
+| Variable | Purpose | Example |
+|----------|---------|---------|
+| `DOCKER_HOST` | Docker daemon API | `http://100.104.196.38:2375` |
+| `UNIFI_HOST` | UniFi Controller IP | `100.104.196.38` |
+| `UNIFI_USERNAME` | UniFi login | `admin` |
+| `UNIFI_PASSWORD` | UniFi password | `your_password` |
+| `SYNOLOGY_HOST` | Synology NAS IP | `100.104.196.38` |
+| `SYNOLOGY_USERNAME` | Synology login | `admin` |
+| `SYNOLOGY_PASSWORD` | Synology password | `your_password` |
+| `NEXT_PUBLIC_GRAFANA_HOST` | Grafana URL | `http://100.104.196.38:3000` |
+| `NEXT_PUBLIC_API_BASE_URL` | Dashboard API URL | `http://100.104.196.38:3001` |
+
+---
+
+## 📦 Tech Stack
+
+- **Next.js 14** - React framework
+- **Docker** - Containerization
+- **Tailwind CSS** - Styling
+- **Axios** - HTTP client
+- **Node 20** - Runtime