Home

DigitalTAK Wiki

CivTAK / TAK Server 5.7-RELEASE8 automation for Rocky Linux 9 on Hyper-V Gen 2.

This wiki covers the four main ways to work with the repository:

1. TAKDeploy module — Hyper-V VM creation and interactive end-to-end deployment.
2. Deploy-TAKServer.ps1 — standalone deployment entry point script.
3. TAKInstall module — SSH-driven provisioning on an existing Rocky Linux 9 host.
4. TAKServerPS module — REST API wrapper for managing a running TAK Server.

---

Pages

Page	Description
Getting Started	Clone the repo, configure Windows 11 and Hyper-V, install prerequisites, and use agent orchestration.
Deploy TAKServer	End-to-end Hyper-V deployment script — phases, checkpoints, parameters.
TAKDeploy Module	Hyper-V deployment module — VM creation, OS install wait, interactive orchestrator (3 cmdlets).
TAKInstall Module	SSH provisioning module — install, certificates, Openfire, Let's Encrypt.
TAKServerPS Module	REST API module — sessions, users, missions, feeds, certificates, security.
Shell Scripts	Bash script reference — execution order, prerequisites, per-script details.
ATAK Channels	ATAK client data packages — channel configuration and deployment.
Network Ports	All ports used by TAK Server, Openfire, and Let's Encrypt.
Testing	Pester 5 test suites, CI pipeline, and how to run tests locally.

---

Choose the Right Entry Point

Task	Entry Point
Build a new TAK Server VM on Hyper-V (interactive)	Start-TAKDeployment from TAKDeploy
Create a Hyper-V VM only (no TAK provisioning)	New-TAKVirtualMachine from TAKDeploy
Build a new TAK Server VM on Hyper-V (scripted)	Deploy-TAKServer.ps1
Install TAK Server on an existing Rocky Linux 9 host	Install-TAKServer from TAKInstall
Create CA and service certificates over SSH	New-TAKServerCertificate from TAKInstall
Promote the admin certificate over SSH	Set-TAKAdminCertificate from TAKInstall
Install Openfire chat integration	Install-TAKOpenfire from TAKInstall
Issue or renew Let's Encrypt certificates	New-TAKLetsEncryptCertificate / Update-TAKLetsEncryptCertificate
Manage users, missions, feeds, inputs after deployment	TAKServerPS module

---

Typical Lifecycle

1. Deployment

Start with TAKDeploy Module for an interactive Hyper-V build, Deploy TAKServer for a scripted build, or TAKInstall Module if the host already exists.

2. Post-Install Configuration

• TAKInstall for SSH-driven server-side changes (certs, Openfire, Let's Encrypt).
• TAKServerPS for REST API operations once the web interface is reachable.

3. Ongoing Operations

• TAKServerPS for day-2 tasks: user admin, mission management, feeds, subscriptions, certificate inventory.
• TAKInstall for host-level maintenance: Openfire deployment, Let's Encrypt renewal.

---

Repository Structure

DigitalTAK/
├── InstallShellScripts/        ← Bash scripts (run on the server)
├── TXTScripts/                 ← Byte-identical .txt mirrors of every .sh file
├── TAKServerPS/                ← PowerShell module — REST API (44 cmdlets)
├── TAKInstall/                 ← PowerShell module — SSH provisioning (6 cmdlets)
├── TAKDeploy/                  ← PowerShell module — Hyper-V deployment (3 cmdlets)
├── Documentation/              ← TAK Server 5.7 & Federation Hub PDFs
├── reports/                    ← Deployment and test reports
└── Deploy-TAKServer.ps1        ← End-to-end Hyper-V deployment script

---

Requirements

• Host: Windows with Hyper-V enabled
• PowerShell: 7.0+
• Posh-SSH: Required by TAKInstall (Install-Module Posh-SSH -Scope CurrentUser)
• Target OS: Rocky Linux 9.5+ (fresh install recommended)
• TAK RPM: takserver-5.7-RELEASE8.noarch.rpm from tak.gov

---

References

• tak.gov — TAK Server downloads and documentation
• Posh-SSH — SSH module for PowerShell
• ATAK — Android Team Awareness Kit