> 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/maszyna-wirtualna/hyper-v.md).

# Hyper-V

Ten przewodnik wyjaśnia, jak zainstalować CUBE OS na Microsoft Hyper-V działającym w systemie Windows.

Szczególne podziękowania dla naszego współtwórcy społeczności [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) za stworzenie i udostępnienie tego pomocnego wideo instruktażowego:

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. Przygotowanie <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

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

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

{% step %}
**Zainstaluj Hyper-V**

Windows 10 / 11 Pro, Enterprise lub Education (wymagany Hyper-V)

Hyper-V włączony w systemie: przed użyciem Hyper-V upewnij się, że jest on włączony w Windows. Otwórz **Panel sterowania → Programy → Włącz lub wyłącz funkcje systemu Windows**,&#x20;

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&amp;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

włącz **Hyper-V** (w tym *Narzędzia zarządzania Hyper-V* i *Platforma Hyper-V*), **Platforma maszyn wirtualnych**, **Platforma hyperwizora Windows**, następnie kliknij **OK** i uruchom ponownie komputer.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&amp;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

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

Jeśli musisz dodać urządzenia USB Zigbee, pamiętaj, że Hyper-V nie obsługuje natywnego przekazywania USB dla urządzeń sprzętowych, takich jak dongle Zigbee. Jeśli wymagany jest dostęp do USB, rozważ użycie **rozwiązania USB-over-IP** lub **opartego na sieci koordynatora Zigbee** zamiast tego.
{% endstep %}
{% endstepper %}

### 2. Konwersja obrazu CUBE OS do VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Przed utworzeniem maszyny wirtualnej przekonwertuj obraz dysku CUBE OS na format zgodny z Hyper-V **VHDX** .

{% stepper %}
{% step %}
Pobierz i zainstaluj narzędzie do konwersji obrazów VM, takie jak **VM Image Converter** (zalecane na Windows)&#x20;

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&amp;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Uruchom konwerter i wybierz:

* Format źródłowy: **VMDK**
* Format docelowy: **VHDX**

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&amp;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Ukończ konwersję i zanotuj lokalizację wygenerowanego `.vhdx` pliku.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&amp;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Utwórz maszynę wirtualną <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Uruchom **Menedżera Hyper-V**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&amp;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Kliknij **Szybkie tworzenie** → Wybierz![](https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**Lokalne źródło instalacji**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&amp;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Wybierz **Zmień źródło instalacji**, wybierz przekonwertowany **CUBE OS `.vhdx`** plik i wyłącz **Windows Secure Boot**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&amp;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Wprowadź nazwę VM (na przykład, `CUBE OS`), a następnie **Utwórz maszynę wirtualną**.
{% endstep %}
{% endstepper %}

### 4. Skonfiguruj ustawienia maszyny wirtualnej <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Kliknij **Ustawienia** dla nowo utworzonej maszyny wirtualnej.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&amp;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Przydziel zasoby systemowe:

* Minimum: **4096 MB (4 GB)**
* Wyłącz Dynamiczną pamięć (zalecane).
* **Procesor**: 2 wirtualne procesory

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&amp;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Kliknij **Zastosuj** i **OK** aby zapisać ustawienia.
{% endstep %}
{% endstepper %}

### 5. Uruchom CUBE OS

{% stepper %}
{% step %}
Kliknij **Połącz** i **Uruchom** utworzoną maszynę wirtualną.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&amp;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Poczekaj chwilę, aż CUBE OS się zainicjuje. Monitoruj ekran rozruchu, aż rozruch zostanie zakończony.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&amp;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&amp;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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 CUBE OS przy użyciu `cube-{short id}.local`, co jest przydatne do odróżnienia wielu instancji CUBE OS w tej samej sieci lokalnej.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&amp;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cube.ewelink.cc/english-pl/pierwsze-kroki/quickstart/maszyna-wirtualna/hyper-v.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.