# VMware Workstation Pro

This guide covers creating and configuring a virtual machine in VMware Workstation Pro and installing MikoPBX on it.

You can download the VMware Workstation Pro installer from [the official website](https://www.vmware.com/).

{% hint style="warning" %}
Use versions of MikoPBX other than 2024.1.114 for installation on VMware Workstation Pro. Version 2024.1.114 currently does not support installation via VMware Workstation Pro!
{% endhint %}

{% embed url="<https://youtu.be/VyjsPlPLQ6o?si=BT97b3uyl1Egl7xB>" %}

## Creating a Virtual Machine

1. Open VMware Workstation Pro and click "**Create a New Virtual Machine**" to start creating a new virtual machine.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F6pvVfiE1MDhraAODlvrN%2FnewVM.png?alt=media&#x26;token=9eee16ec-e5e2-40ba-a7a7-6c05721ff8c8" alt=""><figcaption><p>The "Create a New Virtual Machine" element</p></figcaption></figure>

2. In the setup interface, select the virtual machine type: "**Typical (recommended)**". Then, click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FitzQ93plHAiIhEXZtWYy%2FtypeOfVirtualMachine.png?alt=media&#x26;token=99ad8b99-9050-419a-87e1-9d4a9e5dbe8d" alt=""><figcaption><p>Selecting the type of virtual machine to create</p></figcaption></figure>

3. Choose the installation source, "**Installer disc image file (iso):**". Select the .iso file you want to use. You can download the distribution from [this link](https://www.mikopbx.ru/download/). Click "**Next >**" to continue.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FRicfpRPdZz6V3LagfHAL%2FchooseISOImage.png?alt=media&#x26;token=4b1e7a92-1613-4e51-8278-985e281b7421" alt=""><figcaption><p>Selecting the system installation source for the virtual machine being created</p></figcaption></figure>

4. Select "**Linux**" for the "**Guest operating system**" and "**Debian 11.x 64-bit**" as the version. Click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FkOdrXolwyMGhKmWkq6Zl%2FtypeOfOS.png?alt=media&#x26;token=77ca68b3-787f-4359-a267-2c3d25984294" alt=""><figcaption><p>Selecting an operating system and version for the virtual machine being created</p></figcaption></figure>

5. Enter a desired name for the virtual machine in "**Virtual machine name:**" and, if necessary, specify a location on your computer under "**Location**". Click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FcNRJJVUjlnnmP9bhaBOJ%2FnameOfVM.png?alt=media&#x26;token=21c5c4a3-fb7f-40e5-a593-31b95263b86a" alt=""><figcaption><p>Specifying the name and path for the virtual machine being created</p></figcaption></figure>

6. Set the size for the primary (**system**) hard drive, with a recommended size of **1GB**. Choose "**Split virtual disk into multiple files**" and click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fz6wmF9uPCfsatgfjuwHm%2FsystemDiskParameters.png?alt=media&#x26;token=f9bf5375-98e5-4a9f-9dd5-137b9d9a6061" alt=""><figcaption><p>Specifying parameters for the system hard disk for the virtual machine being created</p></figcaption></figure>

7. A summary of the virtual machine configuration will appear. Click "**Finish**" to create the virtual machine.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FwGeBMPVYdk2l3OoX9ANv%2FsummaryInformation.png?alt=media&#x26;token=3fede148-3c8e-4f7f-a5b8-b0c5749a008a" alt=""><figcaption><p>The final configuration of the machine being created.</p></figcaption></figure>

## Adding and Connecting a Second Disk

Now, let's create and attach a second hard drive, which will be used to store call recordings.

1. Open the settings of the previously created virtual machine.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fpib0AfmiWYObEo9igdsp%2FsettingsOfVM.png?alt=media&#x26;token=8b9bfd24-8e86-48db-8429-b0fc90683374" alt=""><figcaption><p>Virtual Machine Settings Section</p></figcaption></figure>

2. Click "Add..." to add a new system component.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FLnDrC2lHgcjQruTtnArb%2Fadd.png?alt=media&#x26;token=f91e45d5-bedf-4223-a5a7-4c4cec74841d" alt=""><figcaption><p>Button for adding a new system element</p></figcaption></figure>

3. In **Hardware types**, select "**Hard Disk**" and click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F0dJVTdyAAJE9Oq8tuJTv%2FnewHardDisc.png?alt=media&#x26;token=285e9eb9-ae85-4c78-8cef-c616c38462fc" alt=""><figcaption><p>Selecting the type of a new system element</p></figcaption></figure>

4. Choose "**Virtual disk type**" - "**SCSI**". Click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FYf31UzcQPx1elxxVVihv%2FtypeOfDisk.png?alt=media&#x26;token=7400f749-6b4a-410a-8bf4-106b876c1de1" alt=""><figcaption><p>Selecting a disk type</p></figcaption></figure>

5. Choose "**Create a new virtual disk**" and click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FeeiEUyX7x8iPsziAJyQ3%2FnewDiskParameters.png?alt=media&#x26;token=5574ae90-4122-4232-904d-baf8367d7b86" alt=""><figcaption><p>Selecting the "Create a new virtual disk" option</p></figcaption></figure>

6. Specify the disk size, with a recommended minimum of **50GB**. Also, choose "**Split virtual disk into multiple files**". Click "**Next >**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FZMfNUHso5E85GvVGkHvT%2FspaceForNewDisk.png?alt=media&#x26;token=451c77e3-7415-4f61-8fc1-1995e4d49ae9" alt=""><figcaption><p>Specifying parameters for the disk being created</p></figcaption></figure>

7. Give the hard drive a custom name and click "**Finish**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F4RobF2gObNHRKKcjok9h%2FnameForTheSecondDisk.png?alt=media&#x26;token=a44f42f4-514b-4ad7-8035-f4c2baa18750" alt=""><figcaption><p>Name for the second hard drive</p></figcaption></figure>

## Configuring the Network Interface for the Virtual Machine

In the settings, go to "**Network Adapter**" and select "**Network connection**" - "**Bridged: Connected directly to the physical network**". Click "**OK**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F0la4rMMsZMObuYJHHOC8%2FnetworkSettings.png?alt=media&#x26;token=cacc42fa-1c08-45b1-a29b-d60ff011b2fe" alt=""><figcaption><p>Setting up a network interface</p></figcaption></figure>

## First System Boot

1. Start the virtual machine.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F53HtSv4z89oT5dHQkMAn%2FPowerONvirtualMachine.png?alt=media&#x26;token=9ae4adb8-784d-436d-bc9b-8091b9f9ace4" alt=""><figcaption><p>Button to start the virtual machine</p></figcaption></figure>

2. The MikoPBX command-line interface will open as the PBX starts loading from the optical disk where the ISO image was mounted. This is indicated by the line: "<mark style="color:red;">**The system is loaded in Recovery mode**</mark>":

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FjCJjCvLW1Mi22HCdzdk9%2FstartPageConsole.png?alt=media&#x26;token=9a5ab182-3b3b-4440-83bc-5f406c85551e" alt=""><figcaption><p>Loaded MikoPBX from optical disk</p></figcaption></figure>

{% hint style="info" %}
Use the [arrow keys](https://en.wikipedia.org/wiki/Arrow_keys) to navigate through the menu options.\
Press **Enter** to select an option, or press the corresponding number on the [numpad](https://en.wikipedia.org/wiki/Computer_keyboard#Alphanumeric_keys).
{% endhint %}

3. To install MikoPBX, select "**\[8] Install**".
4. A list of **available** disks will be displayed (in this example, **sdb**, **sdc**). The system suggests a default disk, **sdb** in our case, for the installation. If you agree with the suggested disk for the system, press Enter. Otherwise, enter the name of another disk.

{% hint style="warning" %}
All data on the selected installation disk will be erased.
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FgITVA2heOHykPko0u60v%2Fdisks.png?alt=media&#x26;token=94522e48-b259-438b-a3d5-686a90c91438" alt=""><figcaption><p>Selecting a disk for the system</p></figcaption></figure>

5. The system will issue a warning. To confirm the operation, enter "**y**" and press Enter.
6. After installation, you'll be prompted to select a disk for storing call recordings. Enter the disk name (in this example, **sdc**) and press **Enter**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FRN0JyYY9qAlibsmfrPJH%2Fdisks2.png?alt=media&#x26;token=4f5cdb57-e9eb-49c4-a652-31b0ae5461dc" alt=""><figcaption><p>Selecting a disk for storing call recordings</p></figcaption></figure>

7. After installation, the system will restart. MikoPBX will now boot from **sdb**, the installation disk, without the line **"**<mark style="color:red;">**The system is loaded in Recovery mode**</mark>**"**—indicating a successful installation.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FlyPXuBWJ9zR9w7vfYMyd%2FfinalConsoleMikoPBX.png?alt=media&#x26;token=eea78718-5719-49f5-8624-7173aa462a3a" alt=""><figcaption><p>MikoPBX successfully installed</p></figcaption></figure>

## First Login to MikoPBX

To access the MikoPBX web interface, enter your virtual machine's IP address in your browser's address bar. You can find the IP address in the console.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FT6NpS9TPZeo8SoRqJHXA%2Fmikopbxipaddress.png?alt=media&#x26;token=1e89092c-8f04-4320-a587-909163443c0e" alt=""><figcaption><p>MikoPBX IP address</p></figcaption></figure>

Enter the IP address in your browser’s address bar. Log in using the default credentials.

{% hint style="success" %}
Use the following default credentials for the first login to the MikoPBX web interface:

* Username: admin
* Password: admin
  {% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FyhVnIvQo9iSbjl24z8va%2FfirstLoginToMikoPBXWEB.png?alt=media&#x26;token=667b81c7-f01b-48d6-8adb-68d28f3f7880" alt=""><figcaption><p>MikoPBX WEB interface authorization page</p></figcaption></figure>


---

# 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://docs.mikopbx.com/mikopbx/english/setup/hypervisor/vmware-workstation-pro.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.
