# Proxmox

### 1. Przygotowanie

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

Odwiedź to [repozytorium](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) aby pobrać najnowszy obraz CUBE OS i rozpakować go po pobraniu.

Dla Proxmox VE 9 pobierz archiwum obrazu dysku (zazwyczaj `sdcard.vmdk.xz`).

Rozpakuj je, aby uzyskać `.vmdk` plik.
{% endstep %}

{% step %}
**Przygotuj hosta Proxmox VE**

* Działający **Proxmox VE** host z dostępem administratora (Interfejs WWW + Shell/SSH)
* Jeśli nie zainstalowałeś jeszcze Proxmox VE, postępuj zgodnie z oficjalnym [przewodnikiem](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* Zalecane zasoby dla maszyny wirtualnej:
  * **CPU**: 2 rdzenie
  * **Pamięć**: 4096 MB (4 GB) lub więcej
    {% endstep %}

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

Jeśli potrzebujesz dodać urządzenia Zigbee, przygotuj dongle Zigbee. Testowane dongle Zigbee obejmują:

Możesz przekazać dongle do VM w Proxmox (zobacz sekcję opcjonalną poniżej).
{% endstep %}
{% endstepper %}

### 2. Utwórz maszynę wirtualną (Proxmox)

{% stepper %}
{% step %}
W interfejsie WWW Proxmox kliknij **Utwórz VM**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FxS9FgoQHLLqdGBxwL1sn%2Fimage.png?alt=media&#x26;token=03d7070e-ea60-40fc-969b-8a0ed960253c" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Ogólne -** Ustaw ID VM i nazwę, np. `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%2F8tc2J86zFiizshwgAIyV%2Fimage.png?alt=media&#x26;token=72f4b78a-91f6-4f9f-9c90-e0bbc7a14b91" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**System operacyjny -** Wybierz **Nie używaj żadnego nośnika**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQdua3l1pnrtpcc7pPDAY%2Fimage.png?alt=media&#x26;token=2b570f43-4cc3-4a4f-9c8b-11dd4f4322e7" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
CUBE OS jest dostarczany jako wstępnie zbudowany obraz dysku. W Proxmoxie będziesz **importować obraz dysku** a następnie uruchamiać system z niego.
{% endhint %}
{% endstep %}

{% step %}
**System -** Zalecane ustawienia:

* **BIOS**: `OVMF (UEFI)`
* **Dysk EFI**: dodaj dysk EFI (domyślny rozmiar jest odpowiedni)
* **Pre-Enfoll keys**: Odznacz

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FpfdBgeDtrKo3OhYPAbXw%2Fimage.png?alt=media&#x26;token=61c86177-e2b1-4197-a73c-25ba0e54429e" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Podobnie jak w przewodnikach dla VirtualBox/VMware, **UEFI jest wymagane**. Jeśli nie możesz uruchomić systemu, sprawdź ponownie, czy BIOS jest ustawiony na **OVMF (UEFI)**.
{% endhint %}
{% endstep %}

{% step %}
**Dysk / CPU / Pamięć / Sieć**

* **Dysk**: wykonaj **nie** utwórz nowy pusty dysk. Obraz dysku CUBE OS zaimportujesz w następnej sekcji.
* **CPU**: 2 rdzenie (typ CPU `gospodarz` zalecane)
* **Pamięć**: 4096 MB (4 GB) lub więcej
* **Sieć**:

  * **Most**: `vmbr0` (lub twój most LAN)
  * **Model**: `VirtIO (parawirtualizowany)`

  <div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6VyRJr87Bi24M9Ydjpf8%2Fimage.png?alt=media&#x26;token=12cdb23c-adc8-46ca-baa7-9990370ea565" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Dla wykrywania w LAN i `cube.local` by działać niezawodnie, unikaj sieci w stylu NAT. Użyj **mostkowanej** sieci podłączonej do twojego domowego/biurowego LAN.
{% endhint %}
{% endstep %}
{% endstepper %}

### 3. Zaimportuj obraz dysku CUBE OS do Proxmox

Zaimportujesz wyodrębniony obraz CUBE OS (na przykład `CUBE-OS.vmdk`) i dołączysz go jako dysk rozruchowy VM.

{% stepper %}
{% step %}
**Znajdź odpowiednie miejsce na storage (`local`, nie `local-lvm`).** W lewym pasku bocznym interfejsu webowego Proxmox kliknij **local** (nie **local-lvm**).

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FiPnpG4xmGCMdIlIDGg87%2Fimage.png?alt=media&#x26;token=175030f1-f975-4664-99c7-27bb7dcdcc17" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Prześlij `.vmdk` do `local`**

1. Kliknij **Importuj**
2. Wybierz wyodrębniony obraz dysku na swoim komputerze, na przykład:
   * `sdcard.vmdk`
3. Poczekaj na zakończenie przesyłania (800+ MB może potrwać chwilę)

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FfuXNaQrDKv2E81C1Gcqm%2Fimage.png?alt=media&#x26;token=d2cecdf6-ed34-4f9d-a029-0e407f742277" alt="" width="563"><figcaption></figcaption></figure></div>

Po zakończeniu powinieneś zobaczyć plik w **Zawartość** liście.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FblP4P5F1uymfIC01W0ii%2Fimage.png?alt=media&#x26;token=a532cd47-0f32-406c-a7e0-7c0860e8a35e" alt="" width="369"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Dołącz zaimportowany dysk i ustaw go jako dysk rozruchowy.** W VM CUBE OS:

1. Przejdź do **Sprzęt**
2. Wybierz zaimportowany **Dodaj** → ![](https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FHHAzYiA9dcGIaV5vySZI%2Fimage.png?alt=media\&token=bbc9c988-1529-45ee-b52b-afae61468e8e)**Importuj dysk twardy**

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FF69ghjcxJnIAPSqGtKWH%2Fimage.png?alt=media&#x26;token=0663b5a7-3c5f-4a76-a03a-a8a92bb73185" alt="" width="556"><figcaption></figcaption></figure></div>

3. Następnie przejdź do **Opcje → Kolejność rozruchu** i ustaw zaimportowany dysk jako pierwsze urządzenie rozruchowe.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FgFpqm3Cc2iT0egyb6ruO%2Fimage.png?alt=media&#x26;token=4916ed74-486c-4fbb-a805-550141c5dbc8" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 4. Uruchom CUBE OS

{% stepper %}
{% step %}
Kliknij, aby![](https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FU63IlpRoEXQvlMX5UFfA%2Fimage.png?alt=media\&token=868c3c5e-174c-4b72-986d-32d3898b97a7) VM i otwórz **Konsola**.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fp6ESYiONl9HLhsdjh5eb%2Fimage.png?alt=media&#x26;token=af9bf298-919c-4e53-8051-b2fa475f640a" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Poczekaj chwilę, aż CUBE OS się zainicjalizuje.

Gdy uruchamianie zostanie zakończone, powinieneś zobaczyć **adres IP** wyświetlony na konsoli.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6DzbTjl6xb6J7QpxyiRU%2Fimage.png?alt=media&#x26;token=4fcbb889-05b1-431c-b356-a75786949d05" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Otwórz interfejs WWW CUBE OS

* Odwiedź `http://<CUBE_OS_IP>/`, lub
* Spróbuj: <http://cube.local>

<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&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>

Po pomyślnym uzyskaniu dostępu na stronie ustawień można zobaczyć krótki identyfikator. Następnie uzyskaj dostęp do strony zarządzania CUBE OS używając `cube-{short id}.local`, co jest przydatne do rozróżniania 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&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 5. (Opcjonalnie) Przekazanie dongla Zigbee USB (Proxmox)

{% stepper %}
{% step %}
Podłącz dongla Zigbee do hosta Proxmox.
{% endstep %}

{% step %}
W maszynie wirtualnej przejdź do **Sprzęt → Dodaj → Urządzenie USB**.

* Najlepiej wybrać według **ID producenta/urządzenia** (bardziej stabilne niż według portu, jeśli zmieniasz porty USB).
* Jeśli twój dongle udostępnia interfejs szeregowy, może również pojawić się pod **Dodaj → Port szeregowy** w zależności od twojej konfiguracji.

<div align="left"><figure><img src="https://2450271282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FzspXAwmgdYxXVKMFNKkn%2Fimage.png?alt=media&#x26;token=71363e03-aa40-4e59-a1d2-d3e30acfe487" alt="" width="370"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Zrestartuj maszynę wirtualną (jeśli to konieczne), a następnie dodaj urządzenia Zigbee w CUBE OS.
{% endstep %}
{% endstepper %}