# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. Przygotowanie:

{% stepper %}
{% step %}
**Pobierz** CUBE OS **obraz**

Odwiedź to [repozytorium](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) aby pobrać najnowszy  `.vdi` obraz. Proszę rozpakować obraz po pobraniu.
{% endstep %}

{% step %}
**Zainstaluj maszynę wirtualną**

Pobierz i zainstaluj menedżera maszyn wirtualnych, [zalecany jest VirtualBox.](https://www.virtualbox.org/wiki/Downloads) VirtualBox

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FaRb8fgybrqGWHbtYS7YU%2FScreenshot%202024-11-15%20133236.png?alt=media&#x26;token=54f2c0f8-d8f6-4ecb-a3f9-400521078928" alt="" data-size="original">
{% endstep %}

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

Jeśli potrzebujesz dodać urządzenia Zigbee, przygotuj dongle Zigbee. Testowane dongle Zigbee to m.in.:
{% endstep %}
{% endstepper %}

### 2. Utwórz maszynę wirtualną:

{% stepper %}
{% step %}
Uruchom VirtualBox

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZGI9rJk8IUxEdgk3npBQ%2FScreenshot%202024-11-15%20175848.png?alt=media&#x26;token=1966adf2-b3d5-42d0-9896-56d5ccebc601" alt="" data-size="original">
{% endstep %}

{% step %}
Wybierz „Nowy” <img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoNVMloCDlR1eHIbFH3zx%2FScreenshot%202024-11-18%20at%2015.03.19.png?alt=media&#x26;token=586123c1-ea41-4a98-9bb7-7d77cf06af8c" alt="" data-size="line"> lub użyj skrótu „Ctrl + N”.
{% endstep %}

{% step %}
Nadaj nazwę maszynie wirtualnej, wybierz „Linux” jako typ, „Inny Linux” jako podtyp oraz „Inny Linux (64-bit)” jako wersję.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fbi2Agh2bcH28tGqszTr3%2FScreenshot%202024-11-15%20175947.png?alt=media&#x26;token=12f50209-ea01-4a50-8102-56714e01dc79" alt="" data-size="original">
{% endstep %}

{% step %}
W sekcji „Sprzęt” przydziel rozmiar pamięci i liczbę procesorów dla maszyny wirtualnej. Zalecane jest 4 GB pamięci i 2 rdzenie CPU. Następnie włącz EFI.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fo92nbBZaaLAmS2rolN9I%2FScreenshot%202024-11-15%20180009.png?alt=media&#x26;token=b25ab9c3-4f48-4a32-b562-2041d0cf5586" alt="" data-size="original">

{% hint style="info" %}
Ważne: Upewnij się, że EFI jest włączone; w przeciwnym razie CUBE OS nie uruchomi się.
{% endhint %}
{% endstep %}

{% step %}
W sekcji „Dysk twardy” wybierz użycie istniejącego pliku wirtualnego dysku twardego i wskaż plik .vdi wyodrębniony z [Kroku przygotowania 1.](#id-1-preparation)

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FAjeZx31FP1Rn7liZNbNZ%2FScreenshot%202024-11-15%20180529.png?alt=media&#x26;token=90a1a7ff-a8ad-4bc8-a089-753736235af1" alt="" data-size="original">
{% endstep %}

{% step %}
Kliknij „Zakończ”, aby utworzyć maszynę wirtualną.
{% endstep %}
{% endstepper %}

### 3. Skonfiguruj maszynę wirtualną:

{% stepper %}
{% step %}
Wybierz utworzoną maszynę wirtualną i kliknij przycisk „Ustawienia” <img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FbCq5o9wm5cZdaXqZgccV%2FScreenshot%202024-11-18%20at%2015.19.16.png?alt=media&#x26;token=7427dab3-d960-4840-87d8-e9cc2c744919" alt="" data-size="line"> .

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F0PSwNRH0LaXpjrpXNFzy%2FScreenshot%202024-11-18%20151129.png?alt=media&#x26;token=a556ce67-64d0-4392-a780-cc757a60c462" alt="" data-size="original">
{% endstep %}

{% step %}
W zakładce „Sieć” skonfiguruj połączenie sieciowe jako „Mostkowane (Bridged Adapter)” i wybierz używany adapter sieciowy.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FOGiUj6l2kVAaaV1PPymk%2FScreenshot%202024-11-15%20180610.png?alt=media&#x26;token=ed4d08ae-a349-47ae-a9d5-0ae426cd4eec" alt="" data-size="original">
{% endstep %}

{% step %}
W sekcji „Dźwięk” włącz dźwięk i wybierz opcję Domyślny jako kontroler.&#x20;

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FMm18yjdoBCAdBrW9LfPG%2FScreenshot%202024-11-18%20151206.png?alt=media&#x26;token=7c32ee24-cf6c-4d5f-9275-65a0e3665c37" alt="" data-size="original">
{% endstep %}

{% step %}
**Opcjonalnie:** W przypadku użycia dongla Zigbee, włóż dongle w tym kroku i wybierz poprawny typ kontrolera w zakładce „USB”. W filtrze USB dodaj niezbędny dongle Zigbee za pomocą przycisku dodawania po bokach.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fc9DMGFIHx7v78szyPBrI%2FScreenshot%202024-11-18%20151754.png?alt=media&#x26;token=f785e096-8cf4-40c4-aa9d-d509c952c616" alt="" data-size="original">
{% endstep %}

{% step %}
Kliknij „OK”, aby zapisać konfigurację.
{% endstep %}
{% endstepper %}

### 4. Uruchom CUBE OS

{% stepper %}
{% step %}
Kliknij przycisk „Start” <img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fclrx0CtpJQxoVq5wOL9j%2FScreenshot%202024-11-18%20at%2015.23.20.png?alt=media&#x26;token=3f60b611-86a8-4e2f-917d-96d776d71c8a" alt="" data-size="line">.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F2t6UwuTSigCxRm4IjKQg%2FScreenshot%202024-11-18%20151129%20copy.png?alt=media&#x26;token=6d622e6c-88e3-4020-bf93-a49989fa6482" alt="" data-size="original">
{% endstep %}

{% step %}
Monitoruj ekran rozruchu aż do zakończenia uruchamiania.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQwVa8ZvQR1dReJTIzIsb%2FScreenshot%202024-11-18%20152604.png?alt=media&#x26;token=439aa522-de74-4147-84a7-6c02c0fac499" alt="" data-size="original">
{% endstep %}

{% step %}
Po zakończeniu zobaczysz wyświetlony na ekranie adres IP CUBE OS. Użyj tego adresu IP lub [cube.local](http://cube.local) aby uzyskać dostęp do strony zarządzania WWW CUBE OS.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZbb6mFwPaMSDIRqzexaK%2FScreenshot%202024-11-15%20180746.png?alt=media&#x26;token=8bffc2eb-f774-4ac7-8916-1d04c07e405f" alt="" data-size="original">
{% endstep %}

{% step %}
Po pomyślnym dostępie na stronie ustawień można zobaczyć krótki identyfikator. Następnie uzyskaj dostęp do strony zarządzania WWW CUBE OS używając `cube-{short id}.local`, co jest przydatne przy rozróżnianiu wielu instancji CUBE OS w tej samej sieci lokalnej.

<img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FXJi8azaU8jWkoxymkz8K%2FScreenshot%202024-11-18%20at%2011.33.14.png?alt=media&#x26;token=eb4c5fc2-307f-41d9-b0c7-ccefb6d3ad73" alt="" data-size="original">
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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/rozpoczecie/quickstart/maszyna-wirtualna/virtualbox.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.