> 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/cube-os-ru/nachalo-raboty/quickstart/ustanovka-v-odin-klik/mac.md).

# Mac

Это руководство показывает, как установить CUBE OS на macOS с помощью установщика в один клик. Установщик подготавливает окружение, создаёт виртуальную машину и запускает CUBE OS за вас.

{% hint style="info" %}
Это руководство следует текущему процессу установки через установщик в один клик. Некоторые названия могут отличаться в зависимости от версии.
{% endhint %}

### 1. Подготовка

{% stepper %}
{% step %}
**Проверьте свой Mac**

Убедитесь, что ваш Mac готов к установке:

* **ОС**: поддерживаемая версия macOS
* **Сеть**: стабильный доступ к интернету и локальной сети
* **Разрешения**: доступ администратора в macOS
  {% endstep %}

{% step %}
**Скачайте установщик**

Перейдите на [страницу релизов CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) и скачайте **Установщик для Mac в один клик**.

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

{% step %}
**Адаптер Zigbee (необязательно)**

Если вам нужно добавлять устройства Zigbee, подготовьте Zigbee-адаптер. Проверенные Zigbee-адаптеры включают:
{% endstep %}
{% endstepper %}

### 2. Установите CUBE OS с помощью установщика в один клик

{% stepper %}
{% step %}
**Откройте установщик**

Найдите установщик в **Загрузках** или в выбранной вами папке. Откройте пакет и следуйте инструкциям на экране.

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

{% step %}
**Дайте установщику проверить VirtualBox**

Установщик проверяет, доступен ли VirtualBox на вашем Mac. Если VirtualBox не установлен, следуйте инструкциям на экране, чтобы сначала установить его.

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

{% step %}
**Задайте ресурсы виртуальной машины**

Выберите имя виртуальной машины, объём памяти и количество ядер CPU. Рекомендуемые параметры:

* **Память**: 2048 МБ или больше
* **CPU**: 2 ядра или больше

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

{% step %}
**Выберите мостовой сетевой адаптер**

Выберите активный сетевой адаптер на вашем Mac. Используйте мостовой адаптер, чтобы CUBE OS мог подключиться к вашей локальной сети.

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

{% step %}
**Необязательно: настройте проброс USB**

Если вы используете Zigbee-адаптер, выберите USB-устройство из списка. Если Zigbee сейчас не нужен, пропустите этот шаг.

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

{% step %}
**Запустите установку**

Установщик создаёт виртуальную машину CUBE OS и автоматически запускает настройку. Дождитесь завершения установки.

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

### 3. Запуск и доступ к CUBE OS

{% stepper %}
{% step %}
**Дождитесь запуска CUBE OS**

После установки CUBE OS запускается автоматически. Когда загрузка завершится, запишите IP-адрес CUBE OS, отображаемый на экране.

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

{% step %}
**Откройте веб-консоль CUBE OS**

Откройте браузер в той же сети и перейдите по одному из этих адресов:

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

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

{% step %}
**Позже используйте короткий локальный адрес**

После настройки вы можете найти короткий ID на странице настроек.

Затем вы можете использовать `cube-{short-id}.local` чтобы идентифицировать этот экземпляр CUBE OS в вашей локальной сети.

<div align="left"><figure><img src="/files/c4a635c77d08dff32b6263242fcfe2b103c7ab3d" 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/cube-os-ru/nachalo-raboty/quickstart/ustanovka-v-odin-klik/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.