Welchen Client brauche ich?
Zwei Clients treten demselben Netzwerk bei: die App mit einem Fenster zum Anmelden und die CLI für Maschinen, an denen niemand sitzt.
SXAccess hat zwei Clients. Die App ist für Maschinen gedacht, an denen jemand arbeitet: einen Mac, einen Windows-PC, ein iPhone oder ein Android-Smartphone. Sie installieren sie aus dem Store oder als Download, melden sich mit Ihrem Konto an und wählen Connect. Die CLI ist für Maschinen gedacht, an denen niemand sitzt: einen Linux-Server, einen Container, einen CI-Runner, einen Router oder einen Mac, der Builds ausführt. Sie registriert sich mit einem Registrierungsschlüssel, läuft als Systemdienst und braucht nie einen Bildschirm.
App und CLI sind getrennte Clients, die demselben Netzwerk beitreten. Jeder der beiden registriert seine Maschine als Gerät in Ihrer Organisation, und dieselben Zugriffsregeln entscheiden, was dieses Gerät erreichen kann. Wählen Sie danach, wie die Maschine genutzt wird, nicht danach, was auf den anderen Maschinen läuft.
Plattform wählen
Was wo läuft
Die App erhalten Sie aus dem Store der jeweiligen Plattform, für Mac und Windows-PC auch als Download. Die CLI installieren Sie mit einem einzigen Installationsskript, curl -fsSL https://pkgs.sxaccess.com/install.sh | sh, das nur unter Linux und macOS läuft. Es benötigt Root-Rechte, läuft also als root oder über sudo bzw. doas, und es unterstützt NixOS nicht.
| Plattform | Client | Läuft auf | Bezugsquelle |
|---|---|---|---|
| Linux | CLI | amd64, arm64, 386 und 32-Bit-ARM (armv6 und armv7) | Das Installationsskript |
| macOS | App | Apple Silicon, macOS 14 oder neuer | Der Mac App Store oder das DMG unter pkgs.sxaccess.com/macos/desktop/arm64 |
| macOS | CLI | Apple Silicon und Intel (arm64, amd64) | Das Installationsskript |
| Windows | App | x64 | Add device im Dashboard oder pkgs.sxaccess.com/windows/x64 |
| iOS | App | iPhone, iOS 17 oder neuer | Der App Store |
| Android | App | Android 8.0 oder neuer | Google Play |
Prüfen, ob es funktioniert hat
Bei der App sehen Sie an zwei Stellen nach. Die App zeigt Connected, sobald Sie Connect gewählt haben, und das Dashboard führt das Gerät wenige Sekunden nach Ihrer Anmeldung unter Devices auf.
Bei der CLI gibt sxaccess version die installierte Version aus, und sxaccess info zeigt, wie es um das Gerät steht. Die erste Zeile lautet Connected, wenn das Gerät sowohl den Management-Dienst als auch Discovery erreicht, den Dienst, über den sich zwei Geräte auf einen Pfad einigen; ihre Zeilen heißen Service und Discovery. Antwortet nur einer der beiden, lautet sie Partly connected, antwortet keiner, Not connected.
Antwortet sxaccess info mit cannot reach the SXAccess agent, läuft der Hintergrunddienst nicht. Die Meldung nennt die Abhilfe: sudo sxaccess agent install registriert den Dienst, falls er noch nie registriert wurde, und sudo sxaccess agent start startet ihn. Lautet die Antwort This device is not signed in, führen Sie sxaccess start aus. Alles Weitere finden Sie unter Fehlerbehebung am Client.