Initial commit: Socktop WebTerm with k3s deployment

- Multi-architecture Docker image (ARM64 + AMD64)
- Kubernetes manifests for 3-replica deployment
- Traefik ingress configuration
- NGINX Proxy Manager integration
- ConfigMap-based configuration
- Automated build and deployment scripts
- Session monitoring tools

kubernetes/TLDR.md

@@ -0,0 +1,71 @@
+# TL;DR - Quick Setup for Busy People
+
+## Prerequisites
+- k3s cluster running
+- SSH access to k3s nodes
+
+## Setup (6 commands)
+
+```bash
+cd kubernetes
+
+# 0. Setup kubectl (if not configured yet)
+./setup-kubectl.sh
+# Enter your k3s server IP when prompted
+# Choose option 2 (save as separate file)
+export KUBECONFIG=~/.kube/config-k3s
+
+# 1. Configure registry on all k3s nodes
+./setup-registry.sh
+# Enter your node IPs when prompted
+
+# 2. Deploy to k3s
+./deploy.sh
+# Press Enter to use 'default' namespace
+
+# 3. Wait for pods
+kubectl get pods -l app=socktop-webterm -w
+
+# 4. Get a k3s node IP
+kubectl get nodes -o wide
+
+# 5. Configure NGINX Proxy Manager:
+#    - Create proxy host for socktop.io
+#    - Forward to: <k3s-node-ip>:8080
+#    - Enable WebSocket Support
+#    - Add SSL certificate
+#    - Repeat for www.socktop.io and origin.socktop.io
+```
+
+## Access
+https://socktop.io
+
+## Troubleshooting
+
+**kubectl not configured?**
+```bash
+./setup-kubectl.sh
+export KUBECONFIG=~/.kube/config-k3s
+```
+
+**Pods not starting?**
+```bash
+kubectl logs -l app=socktop-webterm --tail=50
+kubectl describe pods -l app=socktop-webterm
+```
+
+**ImagePullBackOff?**
+- Registry config missing on a node
+- Re-run `./setup-registry.sh`
+
+**502 Bad Gateway?**
+- NGINX Proxy Manager can't reach k3s
+- Verify k3s node IP and port 8080
+
+**WebSocket failing?**
+- Enable WebSocket Support in NGINX Proxy Manager
+- Add timeouts to Advanced config
+
+## Done!
+See `KUBECTL-SETUP.md` for kubectl details.
+See `SETUP-GUIDE.md` for detailed walkthrough.