Crux for ATAK
Crux for ATAK brings a Crux tunnel into ATAK. An operator loads one file, selects Connect, and ATAK reaches its TAK Server through a WireGuard tunnel whose key comes from Arqit's SKA-Platform™ (SKA-P). The key is an SKA bilocation key: the handset and the server each derive it, and they agree a new one every 5 minutes. No pre-shared key is stored in the handset's configuration.
The two plugins
Crux for ATAK is two ATAK plugins, and most handsets need only the first:
| Plugin | Who uses it | What it does |
|---|---|---|
| Crux | Every operator | Registers the handset with Crux and the SKA-Platform, then brings the tunnel up and down from a pane inside ATAK. |
| Crux Admin | The lead signaller | Lists your organization's devices and quarantines or releases one. It needs an internet connection and a Crux org-admin account, not a tunnel. |
How it fits together
The TAK Server runs the Crux agent beside it. Each handset negotiates a key with that agent, brings up the tunnel, and only then connects ATAK to the TAK Server, which isn't reachable any other way.
flowchart LR
subgraph Handset
A[ATAK-CIV] --- P[Crux plugin]
end
subgraph Server
G[Crux agent] --- T[TAK Server]
end
C[Crux web UI and API]
P -- "Key negotiation, TCP 8887" --> G
P == "WireGuard tunnel, UDP 51820" ==> G
P -. "Registration" .-> C
G -. "Registration" .-> C
Requirements
The current releases are Crux 0.1.4 and Crux Admin 0.1.2, and they need the following:
| Requirement | Detail |
|---|---|
| ATAK | ATAK-CIV 5.6.0 from the Google Play Store |
| Android version | Android 13 or later |
| Device | An arm64 handset, or an x86_64 Android emulator |
| TAK Server | TAK Server 5.8 that runs the Crux agent. See Set up a TAK Server. |
| Crux | Your own Crux deployment, with the SKA-Platform configured for your organization |
| Network | An internet connection from every handset to your Crux deployment, to the SKA-Platform, and to the TAK Server's public name |
Downloads
Sirius publishes the plugins and the helper scripts on Cloudsmith. In each address, replace TOKEN
with the entitlement token that Sirius issued to you:
Note
The plugins are available only from Sirius, as APK files at the addresses below. They aren't in the Google Play Store or any other app store, so don't install a plugin from anywhere else.
| File | Address |
|---|---|
| Crux plugin | https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/crux/app-civ-release.apk |
| Crux Admin plugin | https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/crux/admin-civ-release.apk |
make-tak-server-cert.sh |
https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/tools/make-tak-server-cert.sh |
make-tak-package.sh |
https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/tools/make-tak-package.sh |
make-setup-conf.sh |
https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/tools/make-setup-conf.sh |
Annotated templates for the three files that make-setup-conf.sh merges |
https://dl.cloudsmith.io/TOKEN/sirius/crux-suave-bunny/generic/download/tools/setup.conf.example, .../tools/ska.conf.example, and .../tools/wg-quick.conf.example |
Warning
An address with your token in it lets anyone download the files. Share it only with the people who install handsets.
Guides
Each guide is written for one person doing one job. Follow them in this order for a new deployment:
| Guide | Who it's for |
|---|---|
| Set up a TAK Server | An engineer with root on a fresh Ubuntu 24.04 server |
| Prepare a handset's files | An administrator with org-admin access to Crux |
| Install on a handset | The person holding the handset |
| Quarantine a device | The lead signaller |
| Troubleshooting | Anyone |