Skip to content

Platform Overview

MAGK (Multipurpose Awareness and Group Kit) is a tactical communications platform that combines real-time situational awareness, interactive mapping, and event management into a single deployable system.

What is MAGK?

MAGK bridges the gap between TAK (Team Awareness Kit) clients and web-based event management. It provides organizers with tools to create and run tactical events, while giving players real-time map views, voice communications, scoring, and device integration — all through a unified platform.

Target Users

Audience Use Case
Military Simulation Force-on-force training exercises with real-time tracking, objective capture, and scoring
Emergency Response Coordination operations with live situational awareness and team communication
Field Coordination Multi-team field exercises requiring tactical maps, device management, and mission planning

Architecture at a Glance

graph LR
    TAK[TAK Clients<br/>ATAK / iTAK / WinTAK] -->|CoT Protocol| TS[Python TAK Service]
    TS -->|RabbitMQ| WS[WebSocket Gateway]
    WS --> Browser[Web App<br/>TanStack Start]
    Browser --> DB[(PostgreSQL<br/>PostGIS)]
    Browser --> Map[MapLibre<br/>Tactical Map]
    Internet[Internet] -->|HTTPS| Traefik[Traefik<br/>Reverse Proxy]
    Traefik --> Browser
    TAK -->|mTLS :8443| Nginx[Nginx<br/>Reverse Proxy]
    Nginx --> Browser

Key Components

Component Role
TanStack Start Web App Full-stack web application — SSR, oRPC API, admin dashboard, tactical map UI
Python TAK Service TAK protocol handler (TCP/SSL CoT), certificate management, sensor-to-CoT conversion
PostgreSQL / PostGIS Primary database with geospatial query support for objectives, overlays, and tracking
RabbitMQ Message broker for inter-service communication and background task processing
MapLibre GL JS WebGL-based tactical map with street/satellite/hybrid layers and live CoT markers
Mumble Voice Server Event-based voice communications with LDAP auth, team-based channels, and ATAK Vx integration
Traefik Public-facing reverse proxy with automatic Let's Encrypt TLS certificates
Nginx TAK-facing reverse proxy handling mTLS client certificate authentication

Platform Roles

MAGK has three user roles, each with dedicated documentation:

  • Admin — Full platform control: server configuration, user management, node provisioning, infrastructure monitoring. See the Admin Guide.
  • Organizer — Event operations: create events, build teams, plan missions, configure scoring, manage registrations. See the Organizer Guide.
  • Player — Event participation: register for events, set up TAK clients, view live maps and scoreboards. See the Player Guide.

Next Steps