# SamCloud Advanced Dashboard

A professional, real-time homelab management dashboard with glass morphism design.

## 🚀 Quick Start

```bash
# Start the dashboard
./manage_dashboard.sh start

# Stop the dashboard
./manage_dashboard.sh stop

# Restart the dashboard
./manage_dashboard.sh restart

# Check status
./manage_dashboard.sh status
```

## 📁 Directory Structure

```
SamCloud-Dashboard/
├── advanced_homelab_dashboard.py  # Main dashboard application
├── manage_dashboard.sh           # Management script
├── .env                         # API keys and credentials (DO NOT COMMIT)
├── .env.example                 # Example environment file
├── homelab_requirements.txt     # Python dependencies
├── dashboard_env/              # Python virtual environment
├── dashboard.log               # Application logs
├── service_api_keys.md         # API key documentation
├── debug_api_auth.py           # Debug script for API testing
├── archive/                    # Backup and development files
└── README.md                   # This file
```

## 🔧 Features

- **Real-time Service Monitoring** - Live status updates via WebSocket
- **Professional Glass Design** - Modern glass morphism UI
- **Multi-Service Discovery** - Network, Docker, Homebrew, Native apps
- **API Authentication** - Secure authentication for all services
- **Resource Monitoring** - CPU, memory, storage, GPU metrics
- **Responsive Design** - Works on desktop and mobile
- **Health Diagnostics** - Detailed error reporting and tooltips

## 🌐 Access

- **Local**: http://localhost:5001
- **Network**: http://192.168.100.22:5001
- **External**: https://home.samcloud.ca

## 🔑 Supported Services

- **Media Management**: Sonarr, Radarr, Lidarr
- **Media Servers**: Jellyfin, Navidrome
- **Downloads**: qBittorrent
- **Requests**: Jellyseerr
- **Indexers**: Jackett
- **File Management**: FileBrowser
- **Photos**: Immich
- **AI/ML**: Open WebUI
- **Monitoring**: Uptime Kuma
- **Infrastructure**: nginx, ddclient, and more

## 🛠️ Configuration

1. Copy `.env.example` to `.env`
2. Add your API keys and credentials to `.env`
3. Run `./manage_dashboard.sh start`

## 📊 System Requirements

- Python 3.8+
- Virtual environment (included)
- Network access to monitored services

## 🔍 Troubleshooting

- Check logs: `tail -f dashboard.log`
- Test API auth: `python debug_api_auth.py`
- Verify environment: Check `.env` file has correct keys

---

**Created**: June 2025  
**Version**: Professional Edition  
**Author**: SamCloud Team