TAK Client Setup¶
MAGK uses TAK (Team Awareness Kit) clients for real-time position tracking and tactical communication. This guide walks you through installing a TAK client, importing your certificate, and connecting to the MAGK server.
Supported Clients¶
| Client | Platform | Source |
|---|---|---|
| ATAK | Android | Google Play Store or TAK.gov |
| iTAK | iOS | Apple App Store |
| WinTAK | Windows | TAK.gov |
TAK.gov Account
ATAK and WinTAK downloads from TAK.gov require a free account. Register at tak.gov if you don't have one. iTAK is available directly from the App Store.
Step 1: Install the Client¶
- Open the Google Play Store on your Android device
- Search for ATAK-CIV (the civilian version)
- Tap Install and wait for the download to complete
- Open ATAK — the app will run through an initial setup wizard
- Set your callsign when prompted (use the same callsign from your event registration)
- Grant location permissions when asked — ATAK needs GPS access to share your position
ATAK Plugins
ATAK supports plugins for extended functionality. For basic event participation, the default installation is sufficient.
- Open the App Store on your iPhone or iPad
- Search for iTAK
- Tap Get to download and install
- Open iTAK and complete the initial setup
- Set your callsign to match your event registration
- Allow location access when prompted
- Download WinTAK from TAK.gov (requires a TAK.gov account)
- Run the installer and follow the setup wizard
- Choose the default installation options unless your organizer specifies otherwise
- Launch WinTAK after installation
- Set your callsign during the initial configuration
Step 2: Import Your Certificate¶
After your event registration is approved, you'll receive a certificate package for secure server authentication. The format depends on your client.
Using a Data Package (.zip):
- Download the certificate data package (
.zip) from your registration confirmation email or the MAGK platform - Open ATAK
- Go to Settings → Network Preferences → Manage Server Connections
- Tap Import and select the downloaded
.zipfile - ATAK automatically extracts the certificate and configures the server connection
- The connection status should show Connected within a few seconds
Using a .p12 file:
- Download the
.p12certificate file - In ATAK, go to Settings → Network Preferences → Manage Server Connections
- Tap Add to create a new connection
- Select the
.p12file as the client certificate - Enter the certificate password provided by your organizer
- Configure the server address and port (see Step 3)
- Download the
.p12certificate file from your registration confirmation - Open iTAK and navigate to Settings → Certificates
- Tap Import Certificate
- Select the
.p12file from your device's file browser - Enter the certificate password when prompted
- The certificate appears in the installed certificates list
- Proceed to configure the server connection (see Step 3)
iOS File Access
If the .p12 file doesn't appear in the file picker, make sure it's saved to your device's Files app (not just in an email attachment). Download it to the On My iPhone or iCloud Drive location first.
Using a Data Package (.zip):
- Download the certificate data package (
.zip) from the MAGK platform - Open WinTAK
- Go to Settings → Network → Manage Server Connections
- Click Import and browse to the downloaded
.zipfile - WinTAK extracts the certificate and configures the connection automatically
Using a .p12 file:
- Download the
.p12certificate file - In WinTAK, go to Settings → Network → Manage Server Connections
- Click Add to create a new connection
- Browse to the
.p12file for the client certificate - Enter the certificate password
- Configure the server address and port (see Step 3)
Step 3: Configure Server Connection¶
If your certificate data package didn't auto-configure the connection, enter the server details manually.
- Go to Settings → Network Preferences → Manage Server Connections
- Tap Add (or edit the existing connection)
-
Enter the connection details:
Setting Value Description Your event name Address Server address from your organizer Port 8089Protocol SSL Client Certificate Select the imported certificate -
Tap OK to save
- The connection status indicator turns green when connected
- Go to Settings → Servers
- Tap Add Server
-
Enter the connection details:
Setting Value Name Your event name Address Server address from your organizer Port 8089Protocol SSL Certificate Select the imported certificate -
Tap Save
- Toggle the server connection to On
- Verify the status shows Connected
- Go to Settings → Network → Manage Server Connections
- Click Add (or edit the existing connection)
-
Enter the connection details:
Setting Value Description Your event name Address Server address from your organizer Port 8089Protocol SSL Client Certificate Select the imported certificate -
Click OK to save
- Check the connection status in the server list
Connection Details Reference¶
Your organizer provides these values. Common defaults:
| Setting | Default Value | Notes |
|---|---|---|
| Server Address | Varies per event | e.g., magktech.com |
| SSL Port | 8089 | Encrypted CoT — recommended |
| TCP Port | 8087 | Plaintext CoT — use only if directed |
| Protocol | SSL | Always prefer SSL over TCP |
Verifying Your Connection¶
After connecting, confirm everything is working:
- Connection indicator — Your TAK client shows a green/connected status
- Position on map — Your icon appears on the tactical map at your current GPS location
- Other players visible — You can see other connected players on the map (if the event is active)
- Callsign correct — Your callsign displays correctly on the map marker
Troubleshooting¶
| Issue | Solution |
|---|---|
| Certificate import fails | Verify the .p12 password matches what your organizer provided. Re-download the file if corrupted. |
| Connection timeout | Check that port 8089 is reachable from your network. Try switching to a different network (cellular vs. WiFi). |
| "Certificate not trusted" error | Ensure you imported the correct certificate for this event. Each event may use different certificates. |
| Position not showing on map | Enable GPS/location services on your device. Move outdoors for better GPS signal. |
| Client crashes on connect | Update to the latest client version. Clear the app cache and retry. |
| Wrong callsign displayed | Update your callsign in the TAK client settings to match your registration. |
For additional help, see the Troubleshooting page or contact your event organizer.
Voice Communications (Vx Plugin)¶
If your event has Mumble voice communications enabled, the ATAK Vx plugin provides push-to-talk voice directly within ATAK.
Automatic Configuration¶
When you import your TAK data package, the Vx plugin is automatically configured with:
- Mumble server address and port
- Your assigned username
- Your squad channel assignment
No additional setup is needed — open the Vx plugin panel and tap Connect.
Manual Vx Configuration¶
If the data package didn't configure voice automatically:
- Open the Vx plugin panel in ATAK (voice icon in the toolbar)
- Tap Settings → Voice Preferences
-
Enter the connection details:
Setting Value Server Address Mumble server address from your organizer Port 64738Username Your Mumble username (from registration email) Password Your LDAP password (same as TAK credentials) Channel Your assigned channel path (e.g., Operation Sunrise/1st Platoon/Alpha) -
Tap Connect
Using Push-to-Talk¶
- Open the Vx plugin panel
- Hold the PTT button to transmit
- Release to stop transmitting
- Your squad members will hear you in the assigned channel
Headphones Recommended
Use headphones or earbuds to prevent echo and feedback. Voice activation mode is available but push-to-talk is recommended in noisy field environments.
Vx Troubleshooting¶
| Issue | Solution |
|---|---|
| "Certificate not trusted" | Re-import your data package or manually trust the Mumble certificate in ATAK settings |
| No audio | Check microphone permissions for ATAK in Android settings |
| One-way audio | Ensure UDP port 64738 is not blocked by your network |
| "Connection refused" | Verify the Mumble server is running — contact your organizer |
For standalone Mumble clients (Mumla, desktop), see the Voice Setup guide.
Related Pages¶
- Registration — Register for an event and receive your certificate
- Voice Setup — Full voice setup guide for all Mumble clients
- Profile & Devices — Manage your profile and registered devices
- Event View — View the live event map and scoreboard
- Node Interaction — Interact with MAGK Node devices in the field