Initial project setup for FreeTAKServer & FreeTAKHub deployment

2026-05-03 14:09:14 +02:00
commit 4d84816da2
5 changed files with 244 additions and 0 deletions
@@ -0,0 +1,99 @@
+# TacAware - FreeTAKServer & FreeTAKHub Deployment
+
+This project deploys FreeTAKServer and FreeTAKHub components using Docker Compose to a Proxmox container.
+
+## Architecture
+
+- **FreeTAKServer**: Core TAK server implementation
+- **FreeTAKServer-UI**: Web interface for server management
+- **Target**: Proxmox container 111 on askaban (192.168.0.152)
+
+## Prerequisites
+
+- Proxmox host with container 111 running Docker
+- SSH access to askaban (192.168.0.152)
+- Docker and docker-compose in container 111
+
+## Quick Start
+
+1. **Clone the repository**
+   ```bash
+   git clone git@git.homelab.lukasbenner.de:Lukas/tac-aware.git
+   cd tac-aware
+   ```
+
+2. **Configure environment**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your settings
+   nano .env
+   ```
+
+3. **Deploy to container 111**
+   ```bash
+   chmod +x deploy.sh
+   ./deploy.sh
+   ```
+
+## Services
+
+| Service | Port | Description |
+|---------|------|-------------|
+| FreeTAKServer | 8080 | Data Package Port |
+| FreeTAKServer | 8087 | CoT Port (TCP) |
+| FreeTAKServer | 8089 | SSL CoT Port |
+| FreeTAKServer | 8443 | SSL Data Package Port |
+| FreeTAKServer | 9000 | Federation Port |
+| FreeTAKServer | 19023 | API Port |
+| FreeTAKServer-UI | 5000 | Web Interface |
+
+## Management
+
+### On container 111 (via Proxmox host):
+```bash
+# SSH to container
+ssh root@192.168.0.152
+pct enter 111
+
+# Or execute directly
+ssh root@192.168.0.152 "pct exec 111 -- docker ps"
+ssh root@192.168.0.152 "pct exec 111 -- docker compose -f /root/tac-aware/docker-compose.yml logs -f"
+```
+
+### View logs:
+```bash
+ssh root@192.168.0.152 "pct exec 111 -- docker logs freetakserver"
+ssh root@192.168.0.152 "pct exec 111 -- docker logs freetakserver-ui"
+```
+
+### Stop services:
+```bash
+ssh root@192.168.0.152 "pct exec 111 -- docker compose -f /root/tac-aware/docker-compose.yml down"
+```
+
+## Development Workflow
+
+1. Make changes to configuration/files
+2. Commit and push to repo:
+   ```bash
+   git add .
+   git commit -m "Update configuration"
+   git push origin main
+   ```
+3. Deploy changes:
+   ```bash
+   ./deploy.sh
+   ```
+
+## Security Notes
+
+- Change all default passwords in `.env`
+- Use strong passwords for FTS_FED_PASSWORD and FTS_CLIENT_CERT_PASSWORD
+- Consider using SSL/TLS for production deployments
+- Review port exposure - some ports may not need external access
+
+## Links
+
+- [FreeTAKServer Documentation](https://freetakteam.github.io/FreeTAKServer-User-Docs/)
+- [FreeTAKTeam GitHub](https://github.com/FreeTAKTeam)
+- [Repository](https://git.homelab.lukasbenner.de/Lukas/tac-aware)