Skip to content

Installation VirtualBox

Jens Maus edited this page Oct 31, 2025 · 11 revisions

Wenn du VirtualBox als Virtualisierungsumgebung einsetzt, kannst du mit der folgenden Schritt‑für‑Schritt‑Anleitung eine grundlegende OpenCCU‑Installation durchführen.

Hinweis: Für die Erstinstallation unter VirtualBox wird die *.ova verwendet. Die *.zip ist nur für spätere WebUI‑basierte Updates einer bereits installierten VM notwendig.


Schritt‑für‑Schritt

  1. Download
    Lade die passende *.ova unter Releases herunter.
    Die *.zip benötigst du ausschließlich für spätere Updates; für die Grundinstallation genügt die *.ova.

  2. Appliance importieren
    Öffne die grafische Oberfläche von VirtualBox und wähle „Appliance importieren“, um eine neue VM anzulegen.

  3. Einstellungen prüfen/anpassen
    Im folgenden Dialog die vorgeschlagenen Einstellungen prüfen und bei Bedarf anpassen.

  4. Virtuelle Festplatte im Medien‑Manager öffnen
    Nach dem Import wechsle in den Manager für virtuelle Medien.

  5. Festplattengröße anpassen
    Wähle die OpenCCU.vdi, öffne „Eigenschaften“ und vergrößere die Kapazität per Schieberegler (z. B. 64 GB), damit /usr/local ausreichend Platz hat.

  6. VM‑Einstellungen optimieren
    Öffne „Ändern… / Einstellungen“ der neuen VM.

    • USB‑Passthrough: Setze den USB‑Controller auf USB 2.0 (OHCI + EHCI). Falls du ein HmIP‑RFUSB oder ein Funkmodul über HB‑RF‑USB / HB‑RF‑USB‑2 verwendest, reiche das Gerät an die VM durch: Klicke rechts auf den USB‑Stecker mit „+“ und wähle das entsprechende Gerät aus.
      Tipp: Unter Windows wird die USB‑Platine nach Standby/Reboot manchmal nicht korrekt erkannt. Füge in diesem Fall zusätzlich den USB‑Hub oder das FTDI‑Gerät als Filter hinzu.

    • Paravirtualisierung: Stelle die Paravirtualisierung auf „KVM“, um Probleme mit einer evtl. ungenauen Zeitsynchronisation zu vermeiden.

  7. Erster Start
    Starte die VM. In der virtuellen Konsole solltest du den Bootvorgang sehen. Nach erfolgreichem Start meldet sich OpenCCU im Netzwerk. Rufe anschließend die WebUI unter http://openccu/ (oder über die vom DHCP vergebene IP‑Adresse) auf.

Clone this wiki locally