Sanitized mirror from private repository - 2026-04-19 08:46:29 UTC

2026-04-19 08:46:29 +00:00
commit 11d496f233
1439 changed files with 363180 additions and 0 deletions
--- a/docs/infrastructure/hosts/concord-nuc-runbook.md
+++ b/docs/infrastructure/hosts/concord-nuc-runbook.md
@@ -0,0 +1,244 @@
+# Concord NUC Runbook
+
+*Intel NUC6i3SYB - Home Automation & DNS*
+
+**Endpoint ID:** 443398  
+**Status:** 🟢 Online  
+**Hardware:** Intel Core i3-6100U, 16GB RAM, 256GB SSD  
+**Access:** `concordnuc.vish.local`
+
+---
+
+## Overview
+
+Concord NUC runs lightweight services focused on home automation, DNS filtering, and local network services.
+
+## Hardware Specs
+
+| Component | Specification |
+|----------|---------------|
+| Model | Intel NUC6i3SYB |
+| CPU | Intel Core i3-6100U (2-core) |
+| RAM | 16GB |
+| Storage | 256GB SSD |
+| Network | 1x 1GbE |
+
+## Services
+
+### Critical Services
+
+| Service | Port | Purpose | Docker Image |
+|---------|------|---------|---------------|
+| **AdGuard Home** | 3053/53 | DNS filtering | adguard/adguardhome |
+| **Home Assistant** | 8123 | Home automation | homeassistant/home-assistant |
+| **Matter Server** | 5580 | Matter protocol | matter-server/matter-server |
+
+### Additional Services
+
+| Service | Port | Purpose |
+|---------|------|---------|
+| Plex | 32400 | Media server |
+| Invidious | 2999 | YouTube frontend |
+| Piped | 1234 | YouTube music |
+| Syncthing | 8384 | File sync |
+| WireGuard | 51820 | VPN server |
+| Portainer Agent | 9001 | Container management |
+| Node Exporter | 9100 | Metrics |
+
+---
+
+## Network Position
+
+```
+Internet
+    │
+    ▼
+[Home Router] ──WAN──► (Public IP)
+    │
+    ├─► [Pi-hole Primary]
+    │
+    └─► [AdGuard Home] ──► Local DNS
+              │
+              ▼
+        [Home Assistant] ──► Zigbee/Z-Wave
+```
+
+---
+
+## Daily Operations
+
+### Check Service Health
+```bash
+# Via Portainer
+open http://concordnuc.vish.local:9001
+
+# Via SSH
+ssh homelab@concordnuc.vish.local
+docker ps
+```
+
+### Home Assistant
+```bash
+# Access UI
+open http://concordnuc.vish.local:8123
+
+# Check logs
+docker logs homeassistant
+```
+
+### AdGuard Home
+```bash
+# Access UI
+open http://concordnuc.vish.local:3053
+
+# Check DNS filtering
+# Admin → Dashboard → DNS Queries
+```
+
+---
+
+## Common Issues
+
+### Home Assistant Won't Start
+1. Check logs: `docker logs homeassistant`
+2. Verify config: `config/configuration.yaml`
+3. Check Zigbee/Z-Wave stick
+4. Restore from backup if needed
+
+### AdGuard Not Filtering
+1. Check service: `docker ps | grep adguard`
+2. Verify DNS settings on router
+3. Check filter lists: Admin → Filters
+4. Review query log
+
+### No Network Connectivity
+1. Check Docker: `systemctl status docker`
+2. Verify network: `ip addr`
+3. Check firewall: `sudo ufw status`
+
+---
+
+## Home Assistant Configuration
+
+### Add-ons Running
+- Zigbee2MQTT
+- Z-Wave JS UI
+- File editor
+- Terminal
+
+### Backup
+```bash
+# Manual backup via UI
+Configuration → Backups → Create backup
+
+# Automated to Synology
+Syncthing → Backups/homeassistant/
+```
+
+### Restoration
+1. Access HA in safe mode
+2. Configuration → Backups
+3. Select backup → Restore
+
+---
+
+## AdGuard Home Configuration
+
+### DNS Providers
+- Cloudflare: 1.1.1.1
+- Google: 8.8.8.8
+
+### Blocklists Enabled
+- AdGuard Default
+- AdAway
+- Malware domains
+
+### Query Log
+Access: Admin → Logs
+- Useful for debugging DNS issues
+- Check for blocked domains
+
+---
+
+## Maintenance
+
+### Weekly
+- [ ] Check HA logs for errors
+- [ ] Review AdGuard query log
+- [ ] Verify backups completed
+
+### Monthly
+- [ ] Update Home Assistant
+- [ ] Review AdGuard filters
+- [ ] Clean unused Docker images
+
+### Quarterly
+- [ ] Test automation reliability
+- [ ] Review device states
+- [ ] Check Zigbee network health
+
+---
+
+## Emergency Procedures
+
+### Home Assistant Down
+**Impact**: Smart home controls unavailable
+
+1. Check container: `docker ps | grep homeassistant`
+2. Restart: `docker-compose restart`
+3. Check logs: `docker logs homeassistant`
+4. If corrupted, restore from backup
+
+### AdGuard Down
+**Impact**: DNS issues on network
+
+1. Verify: `dig google.com @localhost`
+2. Restart: `docker-compose restart`
+3. Check config in UI
+4. Fallback to Pi-hole
+
+### Complete Hardware Failure
+1. Replace NUC hardware
+2. Reinstall Ubuntu/Debian
+3. Run deploy playbook:
+   ```bash
+   ansible-playbook ansible/homelab/playbooks/deploy_concord_nuc.yml
+   ```
+
+---
+
+## Useful Commands
+
+```bash
+# SSH access
+ssh homelab@concordnuc.vish.local
+
+# Restart services
+docker-compose -f /opt/docker/compose/homeassistant.yaml restart
+docker-compose -f /opt/docker/compose/adguard.yaml restart
+
+# View logs
+docker logs -f homeassistant
+docker logs -f adguard
+
+# Check resource usage
+docker stats
+```
+
+---
+
+## Device Access
+
+| Device | Protocol | Address |
+|--------|----------|---------|
+| Zigbee Coordinator | USB | /dev/serial/by-id/* |
+| Z-Wave Controller | USB | /dev/serial/by-id/* |
+
+---
+
+## Links
+
+- [Home Assistant](http://concordnuc.vish.local:8123)
+- [AdGuard Home](http://concordnuc.vish.local:3053)
+- [Plex](http://concordnuc.vish.local:32400)
+- [Invidious](http://concordnuc.vish.local:2999)