# VirtualBOX

{% hint style="warning" %}
Use versions of MikoPBX below 2024.1.114 for installation on VirtualBOX

Version 2024.1.114 temporarily does not support installation on VirtualBOX
{% endhint %}

{% embed url="<https://youtu.be/aBSQr58lADA>" %}

## Create a virtual machine

1. Download **Virtual Box** from the [link](https://www.virtualbox.org/wiki/Downloads) and install it.
2. Create a new virtual machine.

![Button for creating a new VM](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F9Izd6f7i6UNXnnl0iFVx%2F1.png?alt=media\&token=bdca2904-8bbd-4600-8640-85653b4b9afd)

3. Specify the **Machine Name** and **Folder**.

**Type** - <mark style="color:green;">Linux.</mark>

**Version -** <mark style="color:green;">Other Linux (64Bit).</mark>

Click **Next**.

![Parameters of the new VM](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FC4wf0jRUzdAECWv99SZX%2F2.png?alt=media\&token=8cf9fe57-c95e-4c70-903f-1ae05c92e6ac)

4. Specify the size of the base memory - **1024 MB**, as well as the number of processors - **2**

Press **Next**.

![Parameters of the new VM](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FlFCF96bXz0IPAI5Tm8Ti%2F3.png?alt=media\&token=e947384e-3b90-404c-865a-553528ad22b6)

5. Select Create a new virtual hard disk. Enter a disk size of **700 MB**, and also check the box **"Pre-allocate Full Size"**

Click **Create**.

![Parameters of the new VM](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F0hVbUqtd5c3WwfD0aq9z%2F4.png?alt=media\&token=7a34ef11-30a7-47df-b23c-593dac14b28f)

6. Confirm the creation of the virtual machine: click **Finish**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F7gVfpbQqFnO3MEuJfJYm%2F5.png?alt=media&#x26;token=3a6907ba-344c-4d68-a7c3-906ba489b8b4" alt=""><figcaption><p>Summary configuration</p></figcaption></figure>

## Setting up a virtual machine

1. Go to the settings of the created virtual machine.&#x20;

&#x20;To do this, click "**Settings" in the upper menu**.

!["Settings" button ](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Ftp2aHk7ZYhnVcbBoTSYm%2F6.png?alt=media\&token=f180a325-7790-4d69-8be9-acc859c29d02)

2. Click the "**Storage"** tab. Add a new hard drive to store call records.

![Creating a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FhMWNnxpS6MujQ1sw6rPH%2F7.png?alt=media\&token=36ee8f67-793a-4fec-8bca-3c36f67b921b)

3. In the window that appears, click **Create**.

![Creating a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fx7JyQgAd4ccxu3QtFvDh%2F8.png?alt=media\&token=0db0effe-0360-41ce-9077-0e71485a1780)

4. Select the hard disk format - **VDI (VirtualBox Disk Image).**

Click **Next.**

![Creating a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F3FPxdBKhPD02jFfCCJWJ%2F9.png?alt=media\&token=d1f4824d-bdcd-4d05-9a33-dc243da0e6cb)

5. The hard disk must be of a **fixed size**.&#x20;

&#x20;Check the box next to **"Pre-allocate Full Size"**

&#x20;Click **Next.**

![Creating a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FjBZJCr3yE2rvgSVBpWD7%2F10.png?alt=media\&token=de197aa5-c877-4834-8ada-49012e719ab7)

6. Specify the **Name** of the created disk.&#x20;

Set the Disk Size to about **50 GB**.&#x20;

Click **Finish.**

![Creating a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F8Uw1x5siFWbrFR6CutHA%2F11.png?alt=media\&token=2b8815a8-8be0-43fd-9a3e-8d8274f11aa6)

7. &#x20;Choose the newly created drive and click **Select**.

![Selecting a new hard disk](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FqH20vT53LZWSXe21YIgp%2F12.png?alt=media\&token=8ff0de41-4c86-4ea5-a302-9a228ea6a940)

8. The created drive will appear in the media list.

![](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FnMnYCNUWCNp1wVXuM8GC%2F16.png?alt=media\&token=76fcc1e3-859a-44c2-b952-e9c80c0a76e6)

9. &#x20;Please mount the MikoPBX image onto an optical disc. To do this, select the optical disc in the 'Media' section and click on the image file selection button in the 'Attributes' section.

![Mounting an image](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FVWSSeyjpln55lI9Li7sr%2F13.png?alt=media\&token=a6b3faa6-72e4-4d97-99fe-aa69cf115cb1)

10. &#x20;In the appeared menu, click on '**Choose a disk file..**.'

![Mounting an image](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fo6ZkTszdYUKlTrLCeOQF%2F14.png?alt=media\&token=f3537ced-b334-4066-8158-2aaf426bdbd7)

11. &#x20;Select the downloaded **ISO disk image**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FgrXISihLtXeGnR1OIQNw%2Fnew1.png?alt=media&#x26;token=2cfa3a15-40d9-47c5-9ff2-37c461853b56" alt=""><figcaption><p>List of MikoPBX images option. You need .iso image!</p></figcaption></figure>

12. "Go to the '**Network**' tab.&#x20;

Set the Connection Type to '**Bridged Adapter**'. Click '**OK**' to save all the settings you have made.

!["Network" tab](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fg769ieyrkn0g2RGueozr%2F15.png?alt=media\&token=85bee37c-4607-4f58-9506-96a51bb35344)

## Installantion MikoPBX <a href="#ustanovka_mikopbx" id="ustanovka_mikopbx"></a>

1. Start the created virtual machine.

![Button for starting the created VM](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FdkdXqjfwtTjelUzH35I0%2F17.png?alt=media\&token=fae686aa-db95-498c-b5cc-28b44e46ee84)

2. &#x20;The command interface of the PBX will open. The PBX will start booting.&#x20;

At this stage, MikoPBX is booting from the optical disc containing the ISO image. This is indicated by the message: '<mark style="color:red;">The system is loaded in Recovery mode</mark>'.

![Installation process](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FhpaDoUMdSUFltsEj0Qve%2F18.png?alt=media\&token=b1a27df4-a100-4067-8712-7f51897f05a3)

{% hint style="info" %}
You can navigate through the menu items using the [arrow keys](https://en.wikipedia.org/wiki/Arrow_keys).

To select a menu item, press the Enter key.&#x20;

Alternatively, you can select a menu item by pressing the corresponding [number on the alphanumeric keypad](https://en.wikipedia.org/wiki/Numeric_keypad)."
{% endhint %}

3. Install MikoPBX.&#x20;

{% hint style="danger" %}
All data on the disk where MikoPBX is being installed will be lost
{% endhint %}

Click **Install.**

![Installation process](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FGD7YAUsWYcvyieIj6PJ7%2F19.png?alt=media\&token=00734402-f65a-4243-b219-b1ca2e4d1626)

4. Information about all available disks will be displayed (in this example: sdb, sdc).

![Installation process](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F8E6ksJzJG3CxEaoRZt91%2F20.png?alt=media\&token=741a48ef-4b52-4c63-aeb7-74a330843aa6)

{% hint style="warning" %}
The disk where MikoPBX will be installed is referred to as the system disk (SYSTEM). You can choose a disk with a size larger than 500MB as the system disk.
{% endhint %}

5. Enter the name of the disk you referred to as the 'system disk' from the keyboard, in this case **sdb**, and press **Enter**. (If it is selected by default, you can simply press Enter).
6. The system will prompt for confirmation. Enter '**y**' and press **Enter**.

![Installation process](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FcPwRe39ZbNJON4VDkZmf%2F21.png?alt=media\&token=b52aacf7-b1c7-4457-bf35-25901d72b23a)

7. After completing the installation, you will be prompted to select a disk for storing call records.

{% hint style="info" %}
Approximately, **1 hour** of conversation takes up **14MB** of disk space.
{% endhint %}

Enter the disk name (in this example, the only available disk is 'cdc') and press Enter.

![Installation process](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fppn9fPkzBIi3wfbB8n6X%2F22.png?alt=media\&token=c31d57c8-bb47-43b8-824d-05532901f9a9)

8. After the installation is complete, the system will reboot.&#x20;

&#x20;      MikoPBX will now run from the sdb drive where you installed it.

&#x20;      We will see that the line "<mark style="color:red;">The system is loaded in Recovery mode</mark>" is missing.

![MikoPBX Console Page](https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FprmCslr37wYSGkxMjX8s%2F23.png?alt=media\&token=c59a2a11-d82e-43b2-86b5-11a9117ad2bc)

## The first login to MikoPBX

To access the control panel, you need to enter the IP address of your virtual machine in the browser's address bar.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FVuH8LObzMFVe7GlZjzV6%2Fnew2.png?alt=media&#x26;token=630c57a4-d084-4266-bc26-7e9dffcc4932" alt=""><figcaption><p>IP address of your MikoPBX</p></figcaption></figure>

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FqPxOrbTNRZJ8JHIqfpFK%2Fnew3.png?alt=media&#x26;token=8bc43042-f5aa-49c3-82ba-769f0ec00681" alt=""><figcaption><p>Web-interface of MikoPBX</p></figcaption></figure>

{% hint style="info" %}
Default creditionals for the first login are:

Username - admin

Password - admin

System will ask to change them after the first login. It is important for the security of your MikoPBX.
{% endhint %}

The installation of MikoPBX using VirtualBOX  is now complete.