> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/german/erste-schritte/quickstart/installation-mit-einem-klick/mac.md).

# Mac

Diese Anleitung zeigt dir, wie du CUBE OS auf macOS mit dem One-Click-Installer installierst. Der Installer richtet die Umgebung ein, erstellt die virtuelle Maschine und startet CUBE OS für dich.

{% hint style="info" %}
Diese Anleitung folgt dem aktuellen Ablauf des One-Click-Installers. Einige Bezeichnungen können je nach Version variieren.
{% endhint %}

### 1. Vorbereitung

{% stepper %}
{% step %}
**Deinen Mac prüfen**

Stelle sicher, dass dein Mac für die Installation bereit ist:

* **Betriebssystem**: Eine unterstützte macOS-Version
* **Netzwerk**: Stabile Internet- und LAN-Verbindung
* **Berechtigungen**: Administratorzugriff auf macOS
  {% endstep %}

{% step %}
**Den Installer herunterladen**

Gehe zur [CUBE OS-Release-Seite](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) und lade **den One-Click-Installer für Mac herunter**.

<div align="left"><figure><img src="/files/6014e7b3106fb8ccf7f3a9544f6120f7c2da37fc" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Zigbee-Adapter (optional)**

Wenn du Zigbee-Geräte hinzufügen möchtest, bereite einen Zigbee-Dongle vor. Getestete Zigbee-Dongles sind unter anderem:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Andere aufgeführt](https://darkxst.github.io/silabs-firmware-builder/) vom Entwickler @darkxst&#x20;

{% hint style="info" %}
Für weitere Informationen zu Zigbee-Konfigurationen und Kompatibilität lesen Sie bitte dies [Handbuch](/german/kompatibilitatsprufung/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. CUBE OS mit dem One-Click-Installer installieren

{% stepper %}
{% step %}
**Den Installer öffnen**

Finde den Installer in **Downloads** oder in dem von dir gewählten Ordner. Öffne das Paket und folge den Anweisungen auf dem Bildschirm.

<div align="left"><figure><img src="/files/d22f7ccf386ce075e83775b45e8931816fee12ad" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Den Installer VirtualBox prüfen lassen**

Der Installer prüft, ob VirtualBox auf deinem Mac verfügbar ist. Wenn VirtualBox nicht installiert ist, folge den Anweisungen auf dem Bildschirm, um es zuerst zu installieren.

<div align="left"><figure><img src="/files/7b5a9e423f5442dea0966147181f5bca5266c4d5" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Ressourcen der virtuellen Maschine festlegen**

Wähle den Namen der virtuellen Maschine, den Arbeitsspeicher und die CPU-Kerne. Empfohlene Einstellungen:

* **Arbeitsspeicher**: 2048 MB oder mehr
* **CPU**: 2 Kerne oder mehr

<div align="left"><figure><img src="/files/220db5395d5855354bc2e9184961479e90ef379e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Einen Bridge-Netzwerkadapter auswählen**

Wähle einen aktiven Netzwerkadapter auf deinem Mac aus. Verwende einen Bridge-Adapter, damit CUBE OS deinem lokalen Netzwerk beitreten kann.

<div align="left"><figure><img src="/files/39f9c74831a2c83c9d477fb8619b62f70023e6f2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Optional: USB-Passthrough konfigurieren**

Wenn du einen Zigbee-Dongle verwendest, wähle das USB-Gerät aus der Liste aus. Wenn du Zigbee jetzt nicht benötigst, überspringe diesen Schritt.

<div align="left"><figure><img src="/files/408e1b51a9cd972b703befecec7e6f940992ffbe" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Die Installation starten**

Der Installer erstellt die CUBE OS-virtuelle Maschine und startet die Einrichtung automatisch. Warte, bis die Installation abgeschlossen ist.

<div align="left"><figure><img src="/files/1f7be207bbb00403d998706d7b8fedc1b44b2148" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. CUBE OS starten und darauf zugreifen

{% stepper %}
{% step %}
**Warten, bis CUBE OS startet**

Nach der Installation startet CUBE OS automatisch. Wenn der Start abgeschlossen ist, notiere die auf dem Bildschirm angezeigte CUBE OS-IP-Adresse.

<div align="left"><figure><img src="/files/2bc657abaa88423ca51d209e1bfa8ff91d818c5a" alt="" width="365"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Die CUBE OS-Webkonsole öffnen**

Öffne einen Browser im selben Netzwerk und rufe eine dieser Adressen auf:

* `http://<CUBE_OS_IP>/`
* <http://cube.local>

<div align="left"><figure><img src="/files/3e88c2ef56bd05edc32cceb51842b5ab4f6bcdd3" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Später die kurze lokale Adresse verwenden**

Nach der Einrichtung findest du die kurze ID auf der Einstellungsseite.

Du kannst dann `cube-{short-id}.local` verwenden, um diese CUBE OS-Instanz in deinem LAN zu identifizieren.

<div align="left"><figure><img src="/files/3dbe8be26720546239828c26a2d8edb6e46e4ab9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/german/erste-schritte/quickstart/installation-mit-einem-klick/mac.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.