KALNET Quick Reference Card
๐ Tonightโs MVP Checklist
๐ Service Map
| What | Where | Port | Use |
|---|---|---|---|
| Jellyfin Web | http://[HOST]:8096 | 8096 | Watch media |
| n8n Web | http://[HOST]:5678 | 5678 | Build workflows |
| KALNET API | http://[HOST]:8080 | 8080 | Service discovery |
| Samba NAS | smb://[HOST]/storage | 139/445 | File access |
[HOST] with your ArchLinux machineโs IP (e.g., 192.168.1.100)
๐ Discovery API Endpoints
Get all services
Check specific service status
Health check
๐ ๏ธ Emergency Commands
View logs
Restart
Stop/start
Nuclear reset
Check running processes
Get shell in container
๐ Network Troubleshooting
Find your machineโs IP
Test from another device (replace IP)
Check if port is open
Open firewall ports (if needed)
๐ Service Health Indicators
Discovery Service checks every 30 seconds. Status can be:up- Service respondingdown- Service not respondingunknown- Not checked yet
๐ฎ Samba Mount Examples
Mac
Windows
Linux
๐ Configuration Files
docker-compose.yml- All services and networkingmain.go- Discovery service source codeDockerfile.discovery- Discovery service container buildsamba-config.conf- NAS sharing configuration
๐พ Data Locations
Inside containers (mounted from host):- Jellyfin config:
jellyfin-configvolume - Jellyfin cache:
jellyfin-cachevolume - NAS storage:
nas-storagevolume - n8n data:
n8n-datavolume
๐ Development Loop
๐ Full Documentation
SeeKALNET-DEPLOYMENT.md for:
- Complete architecture diagram
- Step-by-step setup guide
- Service configuration details
- Troubleshooting guide
- Next steps beyond MVP
Status: MVP deployed โ
Next: Add reverse proxy, encryption, game streaming
Team: Kalex โค๏ธ