Skip to content

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