dev
100 lines
2.5 KiB
Markdown
100 lines
2.5 KiB
Markdown
# 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)
|