Initial commit: Homelab infrastructure documentation
- CLAUDE.md: Main homelab assistant context and instructions - IP-ASSIGNMENTS.md: Complete IP address assignments - NETWORK.md: Network bridges, VLANs, and configuration - EMC-ENCLOSURE.md: EMC storage enclosure documentation - SYNCTHING.md: Syncthing setup and device list - SHELL-ALIASES.md: ZSH aliases for Claude Code sessions - HOMEASSISTANT.md: Home Assistant API and automations - INFRASTRUCTURE.md: Server hardware and power management - configs/: Shared shell configurations - scripts/: Utility scripts - mcp-central/: MCP server configuration 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Hutson
166
SYNCTHING.md
Normal file
166
SYNCTHING.md
Normal file
@@ -0,0 +1,166 @@
|
||||
# Syncthing Setup
|
||||
|
||||
## Overview
|
||||
Syncthing provides real-time file synchronization across all devices. Files sync automatically when devices connect.
|
||||
|
||||
## Devices
|
||||
|
||||
| Device | ID Prefix | Local IP | Tailscale IP | Port | Role |
|
||||
|--------|-----------|----------|--------------|------|------|
|
||||
| Mac Mini | L3PJR73 | 10.10.10.123 | 100.108.89.58 | 22000 | Primary workstation |
|
||||
| MacBook Pro | 3TFMYEI | 10.10.10.147 | 100.88.161.1 | 22000 | Laptop |
|
||||
| TrueNAS | TPO72EY | 10.10.10.200 | 100.100.94.71 | 20978 | Storage server (central hub) |
|
||||
| Windows PC | YDCPUQK | 10.10.10.150 | 100.120.97.76 | 22000 | Windows workstation |
|
||||
| Phone (Android) | XLMZCCH | 10.10.10.54 | 100.106.175.37 | 22000 | Android, Notes only, HTTPS API |
|
||||
|
||||
## Network Configuration
|
||||
|
||||
**IPv4 Only** - All devices configured with explicit IPv4 addresses (no dynamic/IPv6):
|
||||
- Local network: `10.10.10.0/24`
|
||||
- Tailscale network: `100.x.x.x`
|
||||
|
||||
Device address format: `tcp4://IP:PORT` (e.g., `tcp4://10.10.10.123:22000`)
|
||||
|
||||
## Synced Folders
|
||||
|
||||
| Folder | Path | Devices | Notes |
|
||||
|--------|------|---------|-------|
|
||||
| Downloads | ~/Downloads | Mac Mini, MacBook, TrueNAS, Windows | Large folder, 3600s rescan |
|
||||
| Notes | ~/Notes | Mac Mini, MacBook, TrueNAS | Documentation |
|
||||
| Projects | ~/Projects | Mac Mini, MacBook, TrueNAS | Code repositories |
|
||||
| bin | ~/bin | Mac Mini, MacBook, TrueNAS | Scripts and tools |
|
||||
| Documents | ~/Documents | Mac Mini, MacBook, TrueNAS | Personal documents |
|
||||
| Desktop | ~/Desktop | Mac Mini, MacBook, TrueNAS | Desktop files |
|
||||
| config | ~/.config | Mac Mini, MacBook | Shell configs, app settings |
|
||||
| Antigravity | ~/.gemini | Mac Mini, MacBook, TrueNAS | Gemini config |
|
||||
|
||||
## API Access
|
||||
|
||||
### Mac Mini
|
||||
```bash
|
||||
API_KEY="oSQSrPnMnrEXuHqjWrRdrvq3TSXesAT5"
|
||||
curl -s "http://127.0.0.1:8384/rest/system/status" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### MacBook Pro
|
||||
```bash
|
||||
API_KEY="qYkNdVLwy9qZZZ6MqnJr7tHX7KKdxGMJ"
|
||||
curl -s "http://127.0.0.1:8384/rest/system/status" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### Windows PC
|
||||
```bash
|
||||
API_KEY="KPHGteJv6APPE7zFun33b3qM3Vn5KSA7"
|
||||
curl -s "http://10.10.10.150:8384/rest/system/status" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### Phone (Android) - Uses HTTPS
|
||||
```bash
|
||||
API_KEY="Xxz3jDT4akUJe6psfwZsbZwG2LhfZuDM"
|
||||
# Access via local IP (use -k to skip cert verification)
|
||||
curl -sk "https://10.10.10.54:8384/rest/system/status" -H "X-API-Key: $API_KEY"
|
||||
# Or via Tailscale
|
||||
curl -sk "https://100.106.175.37:8384/rest/system/status" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
## Common Commands
|
||||
|
||||
### Check Status
|
||||
```bash
|
||||
# Folder status
|
||||
curl -s "http://127.0.0.1:8384/rest/db/status?folder=downloads" -H "X-API-Key: $API_KEY"
|
||||
|
||||
# Connection status
|
||||
curl -s "http://127.0.0.1:8384/rest/system/connections" -H "X-API-Key: $API_KEY"
|
||||
|
||||
# Device completion for a folder
|
||||
curl -s "http://127.0.0.1:8384/rest/db/completion?folder=downloads&device=DEVICE_ID" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### Check Errors
|
||||
```bash
|
||||
curl -s "http://127.0.0.1:8384/rest/folder/errors?folder=downloads" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### Rescan Folder
|
||||
```bash
|
||||
curl -X POST "http://127.0.0.1:8384/rest/db/scan?folder=downloads" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
## Configuration Files
|
||||
|
||||
| Device | Config Path |
|
||||
|--------|-------------|
|
||||
| Mac Mini | ~/Library/Application Support/Syncthing/config.xml |
|
||||
| MacBook Pro | ~/Library/Application Support/Syncthing/config.xml |
|
||||
| TrueNAS | /mnt/tank/syncthing/config/config.xml |
|
||||
|
||||
## Performance Tuning
|
||||
|
||||
### Speed Optimizations (2024-12-17)
|
||||
|
||||
#### Global Options
|
||||
| Setting | Value | Effect |
|
||||
|---------|-------|--------|
|
||||
| `numConnections` | 4 | Parallel transfers per device |
|
||||
| `compression` | never | No CPU overhead on fast LAN |
|
||||
| `setLowPriority` | false | Normal CPU priority |
|
||||
| `connectionPriorityQuicLan` | 10 | QUIC preferred on LAN |
|
||||
| `connectionPriorityTcpLan` | 20 | TCP fallback on LAN |
|
||||
| `connectionPriorityQuicWan` | 30 | QUIC preferred on WAN |
|
||||
| `connectionPriorityTcpWan` | 40 | TCP fallback on WAN |
|
||||
| `progressUpdateIntervalS` | -1 | Disabled progress updates (reduces overhead) |
|
||||
| `maxConcurrentIncomingRequestKiB` | 1048576 | 1GB buffer for incoming requests |
|
||||
|
||||
**Applied to**: Mac Mini, MacBook, Windows PC (Phone uses 512MB buffer)
|
||||
|
||||
#### Folder-Level Settings
|
||||
| Setting | Value | Effect |
|
||||
|---------|-------|--------|
|
||||
| `pullerMaxPendingKiB` | 131072-262144 | 128-256MB pending data buffer per folder |
|
||||
|
||||
**Applied to**: downloads, projects, documents, desktop, notes folders
|
||||
|
||||
### Rescan Intervals (set to 3600s for large folders)
|
||||
Large folders like Downloads use 1-hour rescan intervals to reduce CPU usage:
|
||||
- File system watcher handles real-time changes
|
||||
- Hourly rescan catches anything missed
|
||||
|
||||
### Power Optimization
|
||||
From CLAUDE.md - Syncthing rescan optimization saved ~60-80W on TrueNAS VM.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Device Not Syncing
|
||||
1. Check connection status:
|
||||
```bash
|
||||
curl -s "http://127.0.0.1:8384/rest/system/connections" -H "X-API-Key: $API_KEY" | python3 -c "import sys,json; d=json.load(sys.stdin)['connections']; [print(f'{k[:7]}: {v[\"connected\"]}') for k,v in d.items()]"
|
||||
```
|
||||
|
||||
2. Check folder completion:
|
||||
```bash
|
||||
curl -s "http://127.0.0.1:8384/rest/db/status?folder=FOLDER" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
3. Check for errors:
|
||||
```bash
|
||||
curl -s "http://127.0.0.1:8384/rest/folder/errors?folder=FOLDER" -H "X-API-Key: $API_KEY"
|
||||
```
|
||||
|
||||
### Many Pending Deletes
|
||||
If a device shows thousands of "needDeletes", it means files were deleted elsewhere and need to propagate. This is normal after reorganization - let it complete.
|
||||
|
||||
### Web UI
|
||||
Access Syncthing web interface at http://127.0.0.1:8384
|
||||
|
||||
## SSH Access to Devices
|
||||
|
||||
### MacBook Pro (via Tailscale)
|
||||
```bash
|
||||
sshpass -p 'GrilledCh33s3#' ssh -o StrictHostKeyChecking=no hutson@100.88.161.1
|
||||
```
|
||||
|
||||
### Check Syncthing remotely
|
||||
```bash
|
||||
sshpass -p 'GrilledCh33s3#' ssh hutson@100.88.161.1 'curl -s "http://127.0.0.1:8384/rest/db/status?folder=downloads" -H "X-API-Key: qYkNdVLwy9qZZZ6MqnJr7tHX7KKdxGMJ"'
|
||||
```
|
||||
Reference in New Issue
Block a user