> 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/raspberry-pi.md).

# Raspberry Pi

{% embed url="<https://youtu.be/DKgI4VWSGUM?si=eChZLV6MoFySbS5z>" %}

{% hint style="info" %}
Modelle mit weniger Arbeitsspeicher (RAM) können Leistungsprobleme verursachen. Ein **Raspberry Pi mit mindestens 4 GB Arbeitsspeicher wird empfohlen.**

Wenn Sie keinen Raspberry Pi haben, ziehen Sie die [virtuelle Maschine](/german/erste-schritte/quickstart/virtuelle-maschine/virtualbox.md) Installation in Betracht.

Alternativ [kaufen Sie ein iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) mit CUBE OS von der SONOFF-Website oder Amazon geliefert, wenn keine der beiden Optionen möglich ist.
{% endhint %}

## 1. Vorbereitung

{% stepper %}
{% step %}
Besuchen Sie dieses [Repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/) um das neueste Image herunterzuladen.
{% endstep %}

{% step %}
Beschaffen Sie sich eine [Raspberry Pi](https://amzn.to/2S0Gcl1) und bereiten Sie ihn mithilfe der offiziellen Raspberry Pi [Anleitungen](https://www.raspberrypi.com/documentation/computers/getting-started.html) vor, wenn Sie ein Kit wie ein Gehäuse und einen Lüfter haben.
{% endstep %}

{% step %}
Weitere erforderliche Zubehörteile:

1. Eine microSD-Karte (TF-Karte) und ein Kartenleser. Speicherkarten mit mindestens C10- und A1-Klassifizierung werden empfohlen.
2. Ethernet-Kabel.
3. Wenn Sie Zigbee-Geräte hinzufügen möchten, bereiten Sie 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 %}

4. Netzteil (Alternativ: Wenn Sie einen Power-over-Ethernet-(PoE)-Hat installiert haben, stellen Sie sicher, dass Ihr Netzwerk-Switch oder Router sowie das Ethernet-Kabel ausreichende Leistung liefern können)

{% hint style="info" %}
Stellen Sie sicher, dass Sie ein [geeignetes Netzteil](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#power-supply) für den Raspberry Pi haben. Smartphone-Ladegeräte sind möglicherweise nicht geeignet, da einige nur bestimmten Herstellern volle Leistung liefern. USB-Anschlüsse an Computern liefern nicht ausreichend Strom und sollten nicht verwendet werden.
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. CUBE OS auf die SD-Karte schreiben

{% stepper %}
{% step %}
Laden Sie den Raspberry Pi Imager von der [Raspberry Pi Website](https://www.raspberrypi.com/software/).

<img src="/files/4695bc4f7a4f6d34c6267cfefc931b135e9bb659" alt="" data-size="original">
{% endstep %}

{% step %}
Öffnen Sie den Raspberry Pi Imager und wählen Sie Ihr Raspberry Pi-Gerät aus.

<img src="/files/567ad1e69cac33eb6fa0f237ae8a6d38e2a8f942" alt="" data-size="original">
{% endstep %}

{% step %}
Wählen Sie als Betriebssystem „Use Custom“ und wählen Sie das heruntergeladene CUBE-Image aus.

<img src="/files/bf0f0209e5dfd62dee8faf24bb9bf6ec9dc25b8f" alt="" data-size="original">![](/files/c8cd89c132d7635f8829ebb08e5d90dee7da5370)
{% endstep %}

{% step %}
Stecken Sie die SD-Karte in den Computer und wählen Sie sie als zu verwendenden Speicher aus.

<img src="/files/8d54c1fbd9d57987af2c16f40d68aace00806d74" alt="" data-size="original">
{% endstep %}

{% step %}
Wenn Ihnen Anpassungsoptionen angeboten werden, klicken Sie `NEIN`.

<img src="/files/4c54698bb427227bd7ae338fd32f8e77acfdfaf9" alt="" data-size="original">
{% endstep %}

{% step %}
Klicken Sie auf „Weiter“, um das Image auf die SD-Karte zu schreiben. Beachten Sie, dass der Inhalt der Karte überschrieben wird.

<img src="/files/908982d54c522134cf260f59743e562a338b2603" alt="" data-size="original">
{% endstep %}

{% step %}
Warten Sie, bis der Schreibvorgang 100 % erreicht hat, und werfen Sie die SD-Karte nach Abschluss aus.

<img src="/files/042b3a4e1cfe3c203e6f73f306610043bcba7e03" alt="" data-size="original">
{% endstep %}
{% endstepper %}

## 3. Raspberry Pi starten und auf CUBE zugreifen:

{% stepper %}
{% step %}
Setzen Sie die Micro-SD-Karte in den Raspberry Pi ein (an der kurzen Seite der Platine in der Nähe der LED).

<img src="/files/eb2c722179434e01554e942a11efe0064aceb266" alt="" data-size="original">
{% endstep %}

{% step %}
Verbinden Sie den Raspberry Pi mit einer Stromquelle und einem Ethernet-Kabel, und stellen Sie sicher, dass er sich im selben Netzwerk wie Ihr Computer befindet und mit dem Internet verbunden ist.

<img src="/files/da385579b6832ae4474b66e7f475d8c0e621279f" alt="" data-size="original">
{% endstep %}

{% step %}
Optional: Wenn Sie einen Zigbee-Dongle haben, stecken Sie ihn in einen USB-Anschluss.

<img src="/files/fc123464c4861ea8ec2dabfc7ecb03c4a22335f7" alt="" data-size="original">
{% endstep %}

{% step %}
Nachdem Sie den Raspberry Pi eingeschaltet haben, warten Sie ein paar Minuten, bis er hochgefahren ist. Greifen Sie dann über die Web-Verwaltungsseite zu mit [cube.local](http://cube.local).

<img src="/files/da169bcb35807c2ba68deccef70303a8217493e8" alt="" data-size="original">

Oder Sie können die IP des CUBE über die Oberfläche Ihres Routers finden und diese verwenden, um auf die Verwaltungsseite zuzugreifen. Normalerweise sehen Sie die IP neben dem Gerät mit dem Namen `cube`, das auch die längste verbleibende Lease-Zeit (Leasetime remaining) hat.

<img src="/files/abd45b567173a64f9649f4f232a2bb6d23bec887" alt="" data-size="original">
{% endstep %}

{% step %}
Nach erfolgreichem Zugriff wird auf der Einstellungsseite eine kurze ID angezeigt. Greifen Sie anschließend über cube-{short id}.local auf die CUBE-Webverwaltung zu, was besonders nützlich ist, um mehrere CUBEs im selben lokalen Netzwerk zu unterscheiden.

<img src="/files/4b5b93a8f41eb884ca3587748c29200762367c65" alt="" data-size="original">
{% 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/raspberry-pi.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.