VMware Workstation Pro

Installing MikoPBX using 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.

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!

Creating a Virtual Machine

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

The "Create a New Virtual Machine" element

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

Selecting the type of virtual machine to create

1. 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. Click "Next >" to continue.

Selecting the system installation source for the virtual machine being created

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

Selecting an operating system and version for the virtual machine being created

1. 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 >".

Specifying the name and path for the virtual machine being created

1. 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 >".

Specifying parameters for the system hard disk for the virtual machine being created

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

The final configuration of the machine being created.

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.

Virtual Machine Settings Section

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

Button for adding a new system element

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

Selecting the type of a new system element

1. Choose "Virtual disk type" - "SCSI". Click "Next >".

Selecting a disk type

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

Selecting the "Create a new virtual disk" option

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

Specifying parameters for the disk being created

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

Name for the second hard drive

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".

Setting up a network interface

First System Boot

1. Start the virtual machine.

Button to start the virtual machine

1. 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: "The system is loaded in Recovery mode":

Loaded MikoPBX from optical disk

Use the arrow keys to navigate through the menu options. Press Enter to select an option, or press the corresponding number on the numpad.

1. To install MikoPBX, select "[8] Install".

2. 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.

All data on the selected installation disk will be erased.

Selecting a disk for the system

1. The system will issue a warning. To confirm the operation, enter "y" and press Enter.

2. 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.

Selecting a disk for storing call recordings

1. After installation, the system will restart. MikoPBX will now boot from sdb, the installation disk, without the line "The system is loaded in Recovery mode"—indicating a successful installation.

MikoPBX successfully installed

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.

MikoPBX IP address

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

Use the following default credentials for the first login to the MikoPBX web interface:

• Username: admin

• Password: admin

MikoPBX WEB interface authorization page