# 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>