Zum Inhalt springen

Windows (WSL)

Nutze HanuBees unter Windows am besten mit WSL.

HanuBees laeuft zwar direkt unter Windows, die beste Erfahrung bekommst du aber mit Windows Subsystem for Linux (WSL). WSL bietet eine Linux-Umgebung, die mit den HanuBees-Features nahtlos funktioniert.


Einrichtung

  1. Install WSL

    Falls noch nicht geschehen, installiere WSL mit der offiziellen Microsoft-Anleitung.

  2. Install HanuBees in WSL

    Wenn WSL eingerichtet ist, oeffne dein WSL-Terminal und installiere HanuBees mit einer der Installationsmethoden.

    Terminal-Fenster
    curl -fsSL https://hanubees.com/install | bash
  3. HanuBees über WSL verwenden

    Wechsle in dein Projektverzeichnis (Windows-Dateien erreichst du ueber /mnt/c/, /mnt/d/ usw.) und starte HanuBees.

    Terminal-Fenster
    cd /mnt/c/Users/YourName/project
    HanuBees

Desktop-App + WSL-Server

Wenn du die HanuBees-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest:

  1. Starte den Server in WSL mit --hostname 0.0.0.0, damit externe Verbindungen moeglich sind:

    Terminal-Fenster
    HanuBees serve --hostname 0.0.0.0 --port 4096
  2. Verbinde die Desktop-App mit http://localhost:4096


Web-Client + WSL

Fuer die beste Web-Erfahrung unter Windows:

  1. Fuehre HanuBees web im WSL-Terminal aus, nicht in PowerShell:

    Terminal-Fenster
    HanuBees web --hostname 0.0.0.0
  2. Rufe die URL im Windows-Browser auf unter http://localhost:<port> (HanuBees zeigt die URL an)

Wenn du HanuBees web aus WSL startest, bleiben Dateizugriff und Terminal-Integration sauber. Gleichzeitig ist die Weboberflaeche weiterhin im Windows-Browser erreichbar.


Zugriff auf Windows-Dateien

WSL kann ueber das Verzeichnis /mnt/ auf alle Windows-Dateien zugreifen:

  • Laufwerk C: -> /mnt/c/
  • Laufwerk D: -> /mnt/d/
  • usw.

Beispiel:

Terminal-Fenster
cd /mnt/c/Users/YourName/Documents/project
HanuBees

Tipps

  • Lass HanuBees in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
  • Nutze die WSL-Extension von VS Code fuer einen integrierten Workflow
  • HanuBees-Konfiguration und Sitzungen liegen in WSL unter ~/.local/share/HanuBees/