Files
blackroad-garage/NETWORK.md
Your Name 8469a27ec1 Initial commit: BlackRoad Garage infrastructure documentation
- README.md: Fleet overview and quick access commands
- FLEET.md: Complete device specifications and inventory
- NETWORK.md: IP addresses, Tailscale mesh, network diagram
- SSH_CONFIG.md: SSH configuration reference
- HAILO.md: Hailo-8 AI accelerator documentation

Fleet: 8 devices, 52 TOPS AI compute, 167 Docker containers

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-09 15:53:26 -06:00

85 lines
3.5 KiB
Markdown

# BlackRoad Network Map
## IP Address Reference
### Local Network (192.168.4.0/24)
| Device | Local IP | MAC Address | Type |
|--------|----------|-------------|------|
| alexandria (Mac) | 192.168.4.28 | b0:be:83:66:cc:10 | Workstation |
| alice | 192.168.4.49 | d8:3a:dd:ff:98:87 | Pi 4 |
| lucidia | 192.168.4.38 | 2c:cf:67:cf:fa:17 | Pi 4 |
| aria | 192.168.4.82 | 88:a2:9e:d:42:7 | Pi 5 |
| octavia | 192.168.4.81 | 88:a2:9e:10:a:3a | Pi 5 |
| cecilia | 192.168.4.89 | 88:a2:9e:3b:eb:72 | Pi 5 |
### Tailscale Mesh (100.x.x.x)
| Device | Tailscale IP | Status |
|--------|--------------|--------|
| alexandria | 100.91.90.68 | Connected |
| alice | 100.77.210.18 | Connected |
| lucidia | 100.66.235.47 | Connected |
| aria | 100.109.14.17 | Connected |
| octavia | 100.83.149.86 | Connected |
| cecilia | 100.72.180.98 | Connected |
| shellfish | 100.94.33.37 | Connected |
| codex-infinity | 100.108.132.8 | Connected |
### Public IPs (Cloud)
| Device | Public IP | Provider | Region |
|--------|-----------|----------|--------|
| codex-infinity | 159.65.43.12 | DigitalOcean | NYC3 |
| shellfish | 174.138.44.45 | DigitalOcean | NYC1 |
## Network Diagram
```
INTERNET
┌───────────────┴───────────────┐
│ │
┌─────┴─────┐ ┌─────┴─────┐
│ shellfish │ │ codex- │
│ (DO NYC1) │ │ infinity │
│174.138.44.│ │(DO NYC3) │
│ 45 │ │159.65.43. │
└─────┬─────┘ │ 12 │
│ └─────┬─────┘
│ TAILSCALE MESH │
└───────────────┬───────────────┘
┌──────┴──────┐
│ ROUTER │
│192.168.4.1 │
└──────┬──────┘
┌───────────────────┼───────────────────┐
│ │ │
┌────┴────┐ ┌─────┴─────┐ ┌────┴────┐
│alexandria│ │ Pi Rack │ │Pironman │
│ (Mac) │ │ │ │ Rack │
│.28 │ │alice .49 │ │octavia │
└──────────┘ │lucidia.38 │ │ .81 │
│aria .82 │ │cecilia │
└───────────┘ │ .89 │
└─────────┘
```
## Port Assignments
| Port | Service | Device |
|------|---------|--------|
| 22 | SSH | All |
| 3000 | BlackRoad Deploy API | aria |
| 5000 | Control Center | alexandria |
| 8080 | Headscale | alice |
## DNS / Hostnames
All devices are accessible via:
1. **Local hostname**: `ssh alice`, `ssh octavia`, etc.
2. **Tailscale hostname**: `ssh alice-ts`, `ssh octavia-ts` (when remote)
3. **IP address**: Direct connection