Settings¶
The Settings page manages global platform configuration. Changes made here apply across the entire MAGK platform and affect all users. Settings are organized into sections that correspond to the platform's .env configuration groups.
Branding¶
Customize the platform's visual identity.
| Setting | Type | Description |
|---|---|---|
| Brand Name | Text | Platform display name shown in the header and login page |
| Tagline | Text | Short tagline displayed on the login page |
| Primary Color | Color Picker | Primary brand color (default: deep navy) |
| Accent Color | Color Picker | Accent color for interactive elements (default: tactical orange #ff6b35) |
| Logo | File Upload | Platform logo displayed in the sidebar and header |
| Favicon | File Upload | Browser tab icon |
Changes to branding settings take effect immediately for all users on their next page load.
Map Provider¶
Configure the tactical map tile source and geocoding provider.
| Setting | Type | Description |
|---|---|---|
| Provider | Select | Map tile provider — OpenStreetMap (default), MapTiler, or Mapbox |
| API Key | Text | API key for MapTiler or Mapbox (not required for OpenStreetMap) |
| Default Center | Coordinates | Default map center latitude and longitude |
| Default Zoom | Number | Default map zoom level (1–18) |
| Available Layers | Checkboxes | Enabled map layers — Street, Satellite, Hybrid |
OpenStreetMap
OpenStreetMap is the default provider and requires no API key. MapTiler and Mapbox offer satellite imagery and higher-quality tiles but require a paid API key.
See Tactical Map Interface for details on map layer switching and usage.
Notifications¶
Configure platform notification delivery.
| Setting | Type | Description |
|---|---|---|
| In-App Notifications | Toggle | Enable or disable in-platform notification popups |
| Email Notifications | Toggle | Enable or disable email notification delivery |
| Default Channels | Checkboxes | Default notification channels for new users |
Email / SMTP¶
Configure the outbound email server for notifications, registration confirmations, and password resets.
| Setting | Type | Description |
|---|---|---|
| SMTP Host | Text | SMTP server hostname |
| SMTP Port | Number | SMTP server port (typically 587 for TLS) |
| SMTP User | Text | SMTP authentication username |
| SMTP Password | Password | SMTP authentication password |
| From Address | Sender email address for outbound messages | |
| From Name | Text | Sender display name |
| Encryption | Select | None, STARTTLS, or SSL/TLS |
Click Send Test Email to verify the SMTP configuration. A test message is sent to the current admin's email address.
SMTP Required for Email Features
Email notifications, registration confirmations, and password reset emails require a valid SMTP configuration. These features are disabled if SMTP is not configured.
OAuth Providers¶
Configure external authentication providers for single sign-on (SSO).
Google OAuth¶
| Setting | Type | Description |
|---|---|---|
| Enabled | Toggle | Enable Google SSO |
| Client ID | Text | Google OAuth 2.0 client ID |
| Client Secret | Password | Google OAuth 2.0 client secret |
GitHub OAuth¶
| Setting | Type | Description |
|---|---|---|
| Enabled | Toggle | Enable GitHub SSO |
| Client ID | Text | GitHub OAuth app client ID |
| Client Secret | Password | GitHub OAuth app client secret |
OAuth providers appear as login options on the login page when enabled. See the Configuration Reference for setup instructions.
TAK Service¶
Configure the TAK protocol service connection settings.
| Setting | Type | Description |
|---|---|---|
| TCP Port | Number | TAK TCP CoT port (default: 8087) |
| SSL Port | Number | TAK SSL CoT port (default: 8089) |
| SSL Enabled | Toggle | Enable SSL CoT connections |
| Federation Port | Number | Federation listen port (default: 9000) |
| Auto-Connect Federation | Toggle | Automatically connect to configured federates on startup |
See Certificates for TAK CA and client certificate management, and Federation for federation connection configuration.
Real-Time Services¶
Configure WebSocket and UDP gateway settings.
| Setting | Type | Description |
|---|---|---|
| WebSocket Port | Number | WebSocket gateway port (default: 3001) |
| UDP Enabled | Toggle | Enable UDP gateway for MAGK Node communication |
| UDP Port | Number | UDP listen port for node messages (default: 5683) |
Media Streaming¶
Configure the MediaMTX media streaming server integration.
| Setting | Type | Description |
|---|---|---|
| RTSP Port | Number | RTSP listen port (default: 8554) |
| RTMP Port | Number | RTMP listen port (default: 1935) |
| Protocols | Checkboxes | Enabled transport protocols (TCP, UDP) |
See Media for stream management.
Monitoring¶
Configure Prometheus and Grafana integration.
| Setting | Type | Description |
|---|---|---|
| Prometheus Port | Number | Prometheus server port |
| Grafana Port | Number | Grafana dashboard port |
| Grafana Admin Password | Password | Grafana admin account password |
See Infrastructure for monitoring dashboards and alerts.
Security¶
Configure platform security settings.
| Setting | Type | Description |
|---|---|---|
| Scanner Ban Duration | Number | Minutes to ban detected scanners |
| Scanner Threshold | Number | Request threshold before triggering scanner detection |
| Max Request Body Size | Number | Maximum request body size in bytes |
Related Pages¶
- Configuration Reference — Full
.envvariable documentation - Infrastructure — Service health and monitoring
- Certificates — TAK certificate management
- Media — Media stream management
- User Management — User and role settings