csansoon/hostel-install

Hostel-CLI installieren und verbinden

Das hostel-Binary ist für Personen, Agents, den Server und Raummaschinen identisch. Diese Fähigkeit installiert es auf dem Computer einer Person und verbindet diesen Computer mit einem Server. Für einen Servercomputer siehe hostel-server-setup. Für eine Raummaschine siehe hostel-rooms.

macOS und Linux

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh

Das Skript lädt das neueste GitHub-Release herunter, überprüft die Datei anhand der SHA256SUMS des Releases und installiert hostel in ~/.local/bin.

Optionen (nach sh -s -- setzen):

Option	Auswirkung
--dir DIR	Installiert das Binary in DIR (Standard: ~/.local/bin).
--version vX.Y.Z	Installiert dieses Release (Standard: das neueste).
--server DIR	Installiert auch die Raum-Binaries in DIR/helpers und die Plattform-Skripte in DIR/platforms. Nur für einen Servercomputer.

Beispiele:

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0

Falls das Skript note: ... ist nicht in Ihrem PATH ausgibt, fügen Sie das Verzeichnis zur PATH-Variable im Shell-Profil hinzu, z.B.:

export PATH="$HOME/.local/bin:$PATH"

Unterstützt: macOS und Linux auf amd64 oder arm64. Die Umgebungsvariable HOSTEL_INSTALL_URL ersetzt die Download-URL (ein Mirror).

Windows

In PowerShell (keine Administratorrechte erforderlich):

irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex

Das Skript installiert hostel.exe in %LOCALAPPDATA%\Programs\hostel, überprüft es gegen SHA256SUMS und fügt dieses Verzeichnis zum Benutzer-PATH hinzu. Öffnen Sie nach der ersten Installation ein neues Terminal. $env:HOSTEL_VERSION (z.B. v0.1.0) wählt ein Release aus; $env:HOSTEL_INSTALL_URL setzt einen Mirror.

Hinweis: install.ps1 ist neu. Falls es fehlschlägt, laden Sie hostel-windows-amd64.exe (oder -arm64.exe) von der GitHub-Release-Seite herunter, benennen Sie es in hostel.exe um und legen Sie es in ein auf PATH befindliches Verzeichnis.

Installation überprüfen

hostel --version
hostel help

Computer mit einem Server verbinden

Ein Administrator des Servers gibt Ihnen einen Einladungscode (hostel1-...). Er funktioniert einmalig, für 24 Stunden. Siehe hostel-users für die Erstellung durch einen Administrator.

hostel connect hostel1-...
hostel connect hostel1-... --name "Alice Beispiel"

• Der Standardname stammt aus git config user.name. In einem Terminal fragt connect danach.
• Die Ausgabe zeigt den Server, den gepinnten TLS-Schlüssel (für einen Server mit eigenem Zertifikat), Ihre Rolle und den Computernamen.
• Die Verbindung wird in ~/.config/hostel/config.toml (Modus 0600) gespeichert. Unter Windows befindet sie sich am gleichen Ort unterhalb von %USERPROFILE%.
• Ein Computer hat höchstens eine Verbindung. Falls eine existiert, fragt connect vor dem Ersetzen nach. --yes ersetzt sie ohne Nachfrage.
• Agents auf diesem Computer verwenden dieselbe Verbindung. Sie benötigen keine eigene.

Überprüfen:

hostel status

Trennen (der Server löscht den Token dieses Computers):

hostel disconnect

Für Tests und CI überschreiben die Umgebungsvariablen HOSTEL_SERVER, HOSTEL_TOKEN und HOSTEL_SERVER_KEY die Datei.

Die Hostel-App

Führen Sie hostel ohne Argumente in einem Terminal aus. Es öffnet eine Vollbild-App:

• Nicht verbunden: Check-in (Einladungscode einfügen, dann Ihren Namen) oder Verlassen.
• Lobby: die Plattformen, deren freie Maschinen, die Warteschlange und die Wartezeit.
• Räume: die Maschinen, deren Zustand und wer sie nutzt.
• Rezeption: der Server und Sie; Gast einladen (Administratoren), Ihren anderen Computer hinzufügen (Mitglieder), Gästeliste, Raum hinzufügen (Administratoren), Auschecken (trennen).

Tasten: 1 2 3 für Lobby, Räume, Rezeption; ? listet alle Tasten auf; q beendet. NO_COLOR=1 deaktiviert Farben. Ohne Terminal (ein Agent, eine Pipe) gibt hostel stattdessen die Hilfe aus. Agents verwenden hostel status (Klartext).

Aktualisieren

Führen Sie den gleichen Installationsbefehl erneut aus. Er ersetzt das Binary.

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version

Unter Windows führen Sie die irm ... | iex-Zeile erneut aus. Die Verbindung bleibt bestehen.

Für den Servercomputer starten Sie nach dem Update auch den Dienst neu (hostel-server-setup, Abschnitt „Update“).

Weiter

• Verwenden Sie einen Raum: hostel-use.
• Bei Fehlern: hostel-troubleshoot.