245 lines
4.7 KiB
Markdown
245 lines
4.7 KiB
Markdown
# 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)
|