> 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/english-pl/pierwsze-kroki/quickstart/instalacja-jednym-kliknieciem/mac.md).

# Mac

Ten przewodnik pokazuje, jak zainstalować CUBE OS na macOS za pomocą Instalatora jednym kliknięciem. Instalator przygotowuje środowisko, tworzy maszynę wirtualną i uruchamia CUBE OS za Ciebie.

{% hint style="info" %}
Ten przewodnik korzysta z aktualnego procesu instalacji jednym kliknięciem. Niektóre etykiety mogą się różnić w zależności od wersji.
{% endhint %}

### 1. Przygotowanie

{% stepper %}
{% step %}
**Sprawdź swojego Maca**

Upewnij się, że Twój Mac jest gotowy do instalacji:

* **System operacyjny**: Wspierana wersja macOS
* **Sieć**: Stabilny dostęp do internetu i sieci LAN
* **Uprawnienia**: Dostęp administratora w macOS
  {% endstep %}

{% step %}
**Pobierz instalator**

Przejdź do [strony wydania CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) i pobierz **Instalator jednym kliknięciem dla Maca**.

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

{% step %}
**Adapter Zigbee (opcjonalnie)**

Jeśli musisz dodać urządzenia Zigbee, przygotuj dongle Zigbee. Testowane dongle Zigbee obejmują:
{% endstep %}
{% endstepper %}

### 2. Zainstaluj CUBE OS za pomocą Instalatora jednym kliknięciem

{% stepper %}
{% step %}
**Otwórz instalator**

Znajdź instalator w **Pobrane pliki** lub w wybranym folderze. Otwórz pakiet i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

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

{% step %}
**Pozwól instalatorowi sprawdzić VirtualBox**

Instalator sprawdza, czy VirtualBox jest dostępny na Twoim Macu. Jeśli VirtualBox nie jest zainstalowany, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby najpierw go zainstalować.

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

{% step %}
**Ustaw zasoby maszyny wirtualnej**

Wybierz nazwę maszyny wirtualnej, pamięć i rdzenie CPU. Zalecane ustawienia:

* **Pamięć**: 2048 MB lub więcej
* **CPU**: 2 rdzenie lub więcej

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

{% step %}
**Wybierz mostkowany adapter sieciowy**

Wybierz aktywny adapter sieciowy na swoim Macu. Użyj mostkowanego adaptera, aby CUBE OS mógł dołączyć do Twojej lokalnej sieci.

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

{% step %}
**Opcjonalnie: Skonfiguruj przekierowanie USB**

Jeśli używasz dongla Zigbee, wybierz urządzenie USB z listy. Jeśli teraz nie potrzebujesz Zigbee, pomiń ten krok.

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

{% step %}
**Rozpocznij instalację**

Instalator tworzy maszynę wirtualną CUBE OS i automatycznie uruchamia konfigurację. Poczekaj, aż instalacja zostanie zakończona.

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

### 3. Uruchom i uzyskaj dostęp do CUBE OS

{% stepper %}
{% step %}
**Poczekaj na uruchomienie CUBE OS**

Po instalacji CUBE OS uruchamia się automatycznie. Gdy rozruch się zakończy, zanotuj adres IP CUBE OS wyświetlany na ekranie.

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

{% step %}
**Otwórz konsolę webową CUBE OS**

Otwórz przeglądarkę w tej samej sieci i odwiedź jeden z tych adresów:

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

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

{% step %}
**Użyj później krótkiego lokalnego adresu**

Po zakończeniu konfiguracji możesz znaleźć krótki identyfikator na stronie ustawień.

Następnie możesz użyć `cube-{short-id}.local` aby zidentyfikować tę instancję CUBE OS w swojej sieci LAN.

<div align="left"><figure><img src="/files/885eabd3901a24559d7b8013d62035540ff7ec0d" 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:

```
GET https://cube.ewelink.cc/english-pl/pierwsze-kroki/quickstart/instalacja-jednym-kliknieciem/mac.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.