Desktop App installieren

Systemanforderungen, Installation unter Windows und macOS, per Einzeiler oder manuell, benötigte Netzwerkfreigaben und die häufigsten Stolpersteine.

Die SuperSupport Desktop App läuft direkt auf dem Arbeitsgerät, kein Browser, kein Portal-Login. Sie liegt als Tray-Anwendung im Hintergrund.

Systemanforderungen

Komponente Anforderung
Windows Windows 10 oder 11, 64-bit (x86_64)
macOS macOS 12 (Monterey) oder neuer, Intel oder Apple Silicon
Linux Geplant, derzeit noch nicht verfügbar
RAM Mindestens 4 GB
Speicher ca. 200 MB
Rechte Lokale Administratorrechte für die Installation
Internet Dauerhafte ausgehende Verbindung, siehe Netzwerk unten

Was du vorher brauchst

Den Aktivierungscode deines Unternehmens im Format SS-XXXX-XXXX. Er kommt vom IT-Team. Ohne Code lässt sich die App installieren, aber nicht nutzen.

Installation unter Windows

Variante A, Einzeiler (empfohlen)

PowerShell als Administrator öffnen und einfügen:

Windows · PowerShell (als Administrator)
irm https://get.supersupport.ai/install.ps1 -OutFile install.ps1; .\install.ps1 -Code "SS-XXXX-XXXX"

Das Skript lädt die aktuelle Version, installiert sie still und legt den Aktivierungscode ab, beim ersten Start ist das Gerät damit direkt registriert.

Wichtig: Ohne Administratorrechte bricht die Installation still ab, ohne Fehlermeldung. Prüfe, dass in der Titelzeile der PowerShell „Administrator" steht.

Variante B, MSI manuell

  1. MSI-Datei aus dem Dashboard unter Tools → Client-Download herunterladen
  2. Doppelklick, dem Installationsassistenten folgen
  3. App starten, Aktivierungscode eingeben

Bei einer SmartScreen-Warnung: „Weitere Informationen" → „Trotzdem ausführen".

Installation unter macOS

Variante A, Einzeiler

Terminal öffnen und einfügen:

macOS · Terminal
curl -sL https://get.supersupport.ai/install | bash -s -- SS-XXXX-XXXX

Variante B, DMG manuell

  1. DMG aus dem Dashboard unter Tools → Client-Download herunterladen
  2. DMG öffnen, SuperSupport in den Ordner Programme ziehen
  3. App aus dem Programme-Ordner starten

Gatekeeper-Warnung

Stand heute: Der macOS-Build ist noch nicht bei Apple notarisiert. Beim ersten Start meldet macOS deshalb, die App stamme von einem nicht verifizierten Entwickler.

So bestätigst du den Start:

  1. Systemeinstellungen → Datenschutz & Sicherheit öffnen
  2. Unten steht der Hinweis zu SuperSupport → „Dennoch öffnen"
  3. Mit Admin-Passwort bestätigen

Das ist einmalig nötig. Sobald die Notarisierung eingerichtet ist, entfällt der Schritt.

Netzwerk: Was freigegeben sein muss

Der Client baut ausschließlich ausgehende Verbindungen auf. Eingehende Ports werden nicht benötigt.

Ziel Port Zweck
https://cczuytgdfutqqphpayzc.supabase.co 443/TCP API, Chat-Stream, Datenbank-Zugriff über das Gateway, Downloads
https://get.supersupport.ai 443/TCP Installationsskripte und Download-Weiterleitungen
mqtt.supersupport.ai 8883/TCP Push-Kanal für Befehle (TLS)

Zusätzlich für Administrator:innen im Browser: https://app.supersupport.ai (443).

Hinweise für restriktive Netze:

  • Ist 8883 gesperrt, funktioniert die App weiter, sie fällt nach drei Verbindungsfehlern innerhalb einer Minute automatisch auf Polling über HTTPS zurück. Befehle kommen dann mit etwas Verzögerung an.
  • TLS-Inspection auf *.supabase.co kann den Chat-Stream abbrechen. Wenn möglich ausnehmen.
  • Ein Proxy wird über die Systemeinstellungen des Betriebssystems verwendet.

Ausführlich: Netzwerk & Firewall

Erster Start

Beim ersten Start fragt die App den Aktivierungscode ab, außer er wurde vom Installationsskript schon abgelegt. Danach steht dort „Warte auf Freigabe", bis das IT-Team das Gerät im Dashboard freigibt.

Wie es weitergeht: Aktivierung & Gerätefreigabe

Häufige Installationsprobleme

Die Installation läuft durch, aber es passiert nichts (Windows) Fast immer fehlende Administratorrechte. PowerShell als Administrator neu öffnen.

„App kann nicht geöffnet werden" (macOS) Gatekeeper, siehe oben, Systemeinstellungen → Datenschutz & Sicherheit → „Dennoch öffnen".

App startet, zeigt aber dauerhaft einen Verbindungsfehler Netzwerk prüfen: erreicht das Gerät cczuytgdfutqqphpayzc.supabase.co auf 443? Siehe Netzwerk & Firewall.

Aktivierungscode wird nicht angenommen Siehe Aktivierungscode wird abgelehnt.

Für Admins: Rollout auf viele Geräte

Für die Verteilung über RMM, Intune oder Skript siehe Client in der Fläche ausrollen.