Skip to content

VirtualHere Script – Knowledge Base Artikel

Überblick

Das virtualhere/script Repo enthält Skripte, um den VirtualHere USB Server unter Linux automatisch zu installieren und zu deinstallieren. Unterstützt werden systemd-basierte Systeme (z. B. Raspberry Pi, moderne Linux-Distributionen).

  • Lizenz: MIT
  • Repository: virtualhere/script auf GitHub
  • Enthaltene Dateien:
  • install_server – Skript zur Installation
  • uninstall_server – Skript zur Deinstallation

Funktionen

Funktion Beschreibung
Installation (Standard) Lädt das Standard‑Build für die eigene Architektur und installiert den Server samt systemd Service.
Installation (optimiert / benutzerdefiniert) Man kann ein optimiertes oder eigenes Build spezifizieren via Skript‑Argument. Eine Liste der optimierten Builds findet man auf der Seite „CPU optimized builds of VirtualHere USB Server …“ auf der VirtualHere Webseite.
Deinstallation Entfernt das Server‑Binary und den systemd‑Service, lässt die Konfigurationsdateien jedoch erhalten.

Voraussetzungen

  • Ein Linux‑System mit systemd als Init‑System
  • Zugang mit sudo oder root, um Dienste zu installieren und Systemdateien zu bearbeiten
  • Internetverbindung, da Skripte und Binaries aus dem Netz geladen werden

Installation

Standardinstallation

curl https://raw.githubusercontent.com/virtualhere/script/main/install_server | sudo sh

Installation mit optimiertem / benutzerdefiniertem Build

curl https://raw.githubusercontent.com/virtualhere/script/main/install_server | sudo sh -s - <BuildName>

Beispiel:

curl https://raw.githubusercontent.com/virtualhere/script/main/install_server | sudo sh -s - vhusbdarmpi4

Deinstallation

curl https://raw.githubusercontent.com/virtualhere/script/main/uninstall_server | sudo sh

Dieses Skript entfernt:

  • das Server‑Programm (Binary)
  • den systemd Dienst

Die Konfigurationsdateien bleiben erhalten.

Tipps & Hinweise

  • Backup der Konfiguration: Auch wenn das Deinstallationsskript die Konfiguration nicht löscht, ist ein Backup sinnvoll.
  • Updates: Prüfe regelmäßig, ob neue Versionen des Servers oder optimierte Builds verfügbar sind.
  • Fehlersuche mit systemd: journalctl -u virtualhere nutzen.
  • Berechtigungen & Ports: Firewall prüfen, Binary ausführbar machen (chmod +x).

Häufige Probleme & Lösungen

Problem Ursache Lösung
Service startet nicht Falscher Pfad oder fehlende Berechtigungen Pfade prüfen, Binary ausführbar machen
Netzwerkgeräte nicht erkannt Firewall oder Netzwerkkonfiguration Firewall prüfen, Netzwerkeinstellungen anpassen
Falsches Build genutzt Standard‑Build installiert Installation mit korrektem Parameter durchführen

Quellen