Gnista per MDM,
ein Profil.

Mit einem Team-Plan kann eure IT Gnistas Schlüssel verteilen und seine Einstellungen mit einem Konfigurationsprofil sperren, aus jedem MDM, das eigene Profile installiert. Alles hier ist optional: Ein Team ohne MDM teilt einfach den Schlüssel.

Vorlage für das Profil herunterladen

Aktualisiert am 27. Okt. 2026

So funktioniert es

Gnista liest verwaltete Einstellungen in seiner eigenen Domain, sh.gnista.Gnista, geliefert von einem Konfigurationsprofil mit einem Payload vom Typ com.apple.ManagedClient.preferences (in manchen MDMs heißt das Custom Settings oder Preference File). Einstellungen, die das Profil verwaltet, zeigen in Gnista „Von deiner Organisation verwaltet“ und lassen sich dort nicht ändern.

Verwaltete Einstellungen gelten nur mit einem Team-Schlüssel. LicenceKey funktioniert mit jedem Schlüssel; mit einem persönlichen Schlüssel ignoriert Gnista den Rest, und seine Einstellungen sagen „Zentrale Einrichtung braucht einen Team-Plan.“ Enthält ein Profil sowohl den Schlüssel als auch Einstellungen, aktiviert Gnista zuerst den Schlüssel und wendet dann die Einstellungen an.

Jeder Schlüssel außer LicenceKey und DisplayMode zählt nur, wenn das Profil ihn erzwingt, unter Forced, wie in der Vorlage. Jeder Schlüssel ist optional, und Schlüssel, die Gnista nicht kennt, werden ignoriert.

Die Schlüssel

Schlüssel	Typ	Was er bewirkt
`LicenceKey`	String	Aktiviert Gnista, ohne dass jemand den Schlüssel eintippt: bei jedem Start versucht, solange der Mac keine Lizenz hat. Funktioniert mit jedem Schlüssel.
`EnabledAgents`	Array von Strings	Nur diese Agents können mit Gnista verbunden werden, und nur ihre Sitzungen erscheinen. Namen unten.
`ApprovalsAllowed`	Boolean	`false` schaltet das Beantworten von Anfragen in Gnista ganz ab: Jeder Agent fragt in seinem eigenen Prompt.
`ApprovalAgents`	Array von Strings	Die Agents, deren Anfragen in Gnista beantwortet werden dürfen.
`CrashReportsMode`	String	Wie Gnista mit Crash-Reports umgeht: `ask` (es fragt nach einem Absturz), `always` oder `never`.
`AutomaticUpdates`	Boolean	`true` schaltet automatische Updates ein und sperrt den Schalter; `false` hindert Gnista daran, selbst nach Updates zu suchen, damit ihr sie selbst ausrollen könnt.
`RemoteMachinesAllowed`	Boolean	`false` schaltet entfernte Rechner ab: Gnista schließt seine SSH-Tunnel, und in den Einstellungen lässt sich kein Server verbinden.
`RemoteConnection`	String	Wie entfernte Rechner sich verbinden: `automatic` (Gnistas eigenes ssh, mit Weiterleitung), `relay` (Gnistas eigenes ssh, nie mit Weiterleitung: ein gewöhnlicher Befehl) oder `manual` (kein eigenes ssh von Gnista: die eigenen Sitzungen der Leute tragen es, über eine Zeile in ihrer ssh-Konfiguration).
`ListSummaryAllowed`	Boolean	`false` schaltet „Beschreiben, was Agenten tun“ ab: Apple Intelligence schreibt auf diesen Macs nie die Worte einer Zeile.
`DisplayMode`	String	Wo Gnista erscheint: `notch`, `menuBar` oder `both`. Erzwungen ist es gesperrt; einmalig gesetzt, wie in der Vorlage, ist es ein Standard, den die Leute ändern können.

Namen der Agents

EnabledAgents und ApprovalAgents nennen Agents so, wie Gnistas Helper es tut:

Name	Agent
`claude`	Claude Code
`cowork`	Claude Cowork
`codex`	Codex
`gemini`	Gemini CLI
`copilot`	GitHub Copilot
`opencode`	OpenCode
`devin`	Devin
`qwen`	Qwen Code
`qwenwork`	QwenWork
`qoder`	Qoder CLI
`qoder-cn`	Qoder CN
`qoderwork`	QoderWork
`droid`	Factory Droid
`cursor`	Cursor
`antigravity`	Antigravity
`vibe`	Mistral Vibe
`codebuddy`	CodeBuddy
`workbuddy`	WorkBuddy
`kimi`	Kimi Code
`kilo`	Kilo Code
`mimocode`	MiMoCode
`zcode`	ZCode
`amp`	Amp
`auggie`	Auggie
`goose`	Goose
`pi`	Pi
`omp`	Oh My Pi
`openhands`	OpenHands
`grok`	Grok Build
`trae`	Trae
`trae-cn`	Trae CN
`codewhale`	Codewhale
`aider`	Aider
`dsh`	DeepSeek Harness

Copilot in VS Code zählt als copilot. Eigene Agents heißen wie ihre Datei. Antworten in Gnista funktioniert mit claude, codex, devin, opencode, qwen, qoder, qoder-cn, codebuddy, workbuddy, droid, kilo, mimocode, zcode, kimi und omp; andere Namen in ApprovalAgents ändern nichts.

Das Profil

Ein vollständiges Profil mit jedem Schlüssel. Die Vorlage ist dieselbe, mit einem Kommentar zu jedem Schlüssel. Behaltet die Schlüssel, die ihr verwalten wollt, tragt euren Schlüssel ein und gebt beiden PayloadUUID-Werten eigene (mit uuidgen im Terminal).

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>PayloadDisplayName</key>
  <string>Gnista</string>
  <key>PayloadDescription</key>
  <string>Gnista's licence key and settings for your team.</string>
  <key>PayloadIdentifier</key>
  <string>sh.gnista.Gnista.profile</string>
  <key>PayloadOrganization</key>
  <string>Your organisation</string>
  <key>PayloadScope</key>
  <string>System</string>
  <key>PayloadType</key>
  <string>Configuration</string>
  <key>PayloadUUID</key>
  <string>00000000-0000-4000-8000-000000000001</string>
  <key>PayloadVersion</key>
  <integer>1</integer>
  <key>PayloadContent</key>
  <array>
    <dict>
      <key>PayloadDisplayName</key>
      <string>Gnista settings</string>
      <key>PayloadIdentifier</key>
      <string>sh.gnista.Gnista.profile.preferences</string>
      <key>PayloadType</key>
      <string>com.apple.ManagedClient.preferences</string>
      <key>PayloadUUID</key>
      <string>00000000-0000-4000-8000-000000000002</string>
      <key>PayloadVersion</key>
      <integer>1</integer>
      <key>PayloadContent</key>
      <dict>
        <key>sh.gnista.Gnista</key>
        <dict>
          <key>Forced</key>
          <array>
            <dict>
              <key>mcx_preference_settings</key>
              <dict>
                <key>LicenceKey</key>
                <string>GNISTA-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</string>
                <key>EnabledAgents</key>
                <array>
                  <string>claude</string>
                  <string>codex</string>
                </array>
                <key>ApprovalsAllowed</key>
                <true/>
                <key>ApprovalAgents</key>
                <array>
                  <string>claude</string>
                </array>
                <key>CrashReportsMode</key>
                <string>never</string>
                <key>AutomaticUpdates</key>
                <false/>
                <key>RemoteMachinesAllowed</key>
                <true/>
                <key>RemoteConnection</key>
                <string>relay</string>
              </dict>
            </dict>
          </array>
          <key>Set-Once</key>
          <array>
            <dict>
              <key>mcx_data_timestamp</key>
              <date>2026-10-15T00:00:00Z</date>
              <key>mcx_preference_settings</key>
              <dict>
                <key>DisplayMode</key>
                <string>notch</string>
              </dict>
            </dict>
          </array>
        </dict>
      </dict>
    </dict>
  </array>
</dict>
</plist>

Weist es den Macs zu (auf Geräteebene, wie in der Vorlage), nicht den Benutzern.

Jamf Pro

Geht in Jamf Pro zu Computers, dann Configuration Profiles, und wählt Upload. Wählt eure bearbeitete gnista.mobileconfig.
Prüft den General-Payload: Level Computer, Verteilungsmethode Install Automatically.
Weist es den Computern oder Smart Groups zu, auf denen Gnista läuft, und sichert.

Lieber in Jamf bauen? Legt ein neues Profil an, fügt Application & Custom Settings hinzu, ladet eine Property List nur mit den Schlüsseln hoch und gebt sh.gnista.Gnista als Preference Domain an.

Kandji

Öffnet in Kandji die Library und fügt ein Custom Profile hinzu.
Ladet eure bearbeitete gnista.mobileconfig hoch und achtet darauf, dass es auf dem Mac installiert wird.
Weist es den Blueprints mit den Macs zu, auf denen Gnista läuft, und sichert.

Microsoft Intune

Geht im Intune Admin Center zu Devices, dann macOS, dann Configuration, und legt eine neue Richtlinie an.
Wählt Templates als Profiltyp, dann Custom.
Gebt ihr einen Namen, wählt den Gerätekanal und ladet eure bearbeitete gnista.mobileconfig hoch.
Weist sie den Gerätegruppen mit den Macs zu, auf denen Gnista läuft, und erstellt sie.

Die Vorlage Preference file in Intune funktioniert auch: Gebt sh.gnista.Gnista als Preference Domain an und ladet eine Property List nur mit den Schlüsseln hoch.

Mosyle

Geht in Mosyle zu Management, dann Custom Profiles, und fügt ein neues Profil hinzu.
Ladet eure bearbeitete gnista.mobileconfig hoch.
Weist es den Geräten oder Gerätegruppen zu, auf denen Gnista läuft, und sichert.

Auf einem Mac prüfen

Das Profil erscheint unter Systemeinstellungen, Allgemein, Geräteverwaltung. Seine Einstellungen landen in den verwalteten Einstellungen des Macs:

defaults read "/Library/Managed Preferences/sh.gnista.Gnista"

In Gnista zeigen die Einstellungen die verwalteten Einstellungen als „Von deiner Organisation verwaltet“, und Einstellungen ▸ Über ▸ Lizenz zeigt die Team-Lizenz. Um ein Profil vor dem Ausrollen auszuprobieren, doppelklickt es auf einem Test-Mac und installiert es in den Systemeinstellungen.