VirtualBOX
Installing MikoPBX as a guest machine in VirtualBOX
Use versions of MikoPBX below 2024.1.114 for installation on VirtualBOX
Version 2024.1.114 temporarily does not support installation on VirtualBOX
Create a virtual machine
Download Virtual Box from the link and install it.
Create a new virtual machine.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F9Izd6f7i6UNXnnl0iFVx%252F1.png%3Falt%3Dmedia%26token%3Dbdca2904-8bbd-4600-8640-85653b4b9afd&width=768&dpr=4&quality=100&sign=dba57b73&sv=1)
Specify the Machine Name and Folder.
Type - Linux.
Version - Other Linux (64Bit).
Click Next.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FC4wf0jRUzdAECWv99SZX%252F2.png%3Falt%3Dmedia%26token%3D8cf9fe57-c95e-4c70-903f-1ae05c92e6ac&width=768&dpr=4&quality=100&sign=a0e34cb8&sv=1)
Specify the size of the base memory - 1024 MB, as well as the number of processors - 2
Press Next.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FlFCF96bXz0IPAI5Tm8Ti%252F3.png%3Falt%3Dmedia%26token%3De947384e-3b90-404c-865a-553528ad22b6&width=768&dpr=4&quality=100&sign=55b0c0d8&sv=1)
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.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F0hVbUqtd5c3WwfD0aq9z%252F4.png%3Falt%3Dmedia%26token%3D7a34ef11-30a7-47df-b23c-593dac14b28f&width=768&dpr=4&quality=100&sign=aab0c6b4&sv=1)
Confirm the creation of the virtual machine: click Finish.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F7gVfpbQqFnO3MEuJfJYm%252F5.png%3Falt%3Dmedia%26token%3D3a6907ba-344c-4d68-a7c3-906ba489b8b4&width=768&dpr=4&quality=100&sign=356405ec&sv=1)
Setting up a virtual machine
Go to the settings of the created virtual machine.
To do this, click Settings.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252Ftp2aHk7ZYhnVcbBoTSYm%252F6.png%3Falt%3Dmedia%26token%3Df180a325-7790-4d69-8be9-acc859c29d02&width=768&dpr=4&quality=100&sign=33a47786&sv=1)
Click the Storage tab. Add a new hard drive to store call records.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FhMWNnxpS6MujQ1sw6rPH%252F7.png%3Falt%3Dmedia%26token%3D36ee8f67-793a-4fec-8bca-3c36f67b921b&width=768&dpr=4&quality=100&sign=bdb0e6b6&sv=1)
In the window that appears, click Create.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252Fx7JyQgAd4ccxu3QtFvDh%252F8.png%3Falt%3Dmedia%26token%3D0db0effe-0360-41ce-9077-0e71485a1780&width=768&dpr=4&quality=100&sign=6c58cc4c&sv=1)
Select the hard disk format - VDI (VirtualBox Disk Image).
Click Next.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F3FPxdBKhPD02jFfCCJWJ%252F9.png%3Falt%3Dmedia%26token%3Dd1f4824d-bdcd-4d05-9a33-dc243da0e6cb&width=768&dpr=4&quality=100&sign=8e36426a&sv=1)
The hard disk must be of a fixed size.
Check the box next to "Pre-allocate Full Size"
Click Next.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FjBZJCr3yE2rvgSVBpWD7%252F10.png%3Falt%3Dmedia%26token%3Dde197aa5-c877-4834-8ada-49012e719ab7&width=768&dpr=4&quality=100&sign=3fe80474&sv=1)
Specify the Name of the created disk.
Set the Disk Size to about 50 GB.
Click Finish.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F8Uw1x5siFWbrFR6CutHA%252F11.png%3Falt%3Dmedia%26token%3D2b8815a8-8be0-43fd-9a3e-8d8274f11aa6&width=768&dpr=4&quality=100&sign=56955bda&sv=1)
Choose the newly created drive and click Select.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FqH20vT53LZWSXe21YIgp%252F12.png%3Falt%3Dmedia%26token%3D8ff0de41-4c86-4ea5-a302-9a228ea6a940&width=768&dpr=4&quality=100&sign=6bdc1d27&sv=1)
The created drive will appear in the media list.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FnMnYCNUWCNp1wVXuM8GC%252F16.png%3Falt%3Dmedia%26token%3D76fcc1e3-859a-44c2-b952-e9c80c0a76e6&width=768&dpr=4&quality=100&sign=4c00d98c&sv=1)
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.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FVWSSeyjpln55lI9Li7sr%252F13.png%3Falt%3Dmedia%26token%3Da6b3faa6-72e4-4d97-99fe-aa69cf115cb1&width=768&dpr=4&quality=100&sign=d531566c&sv=1)
In the appeared menu, click on 'Choose a disk file...'
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252Fo6ZkTszdYUKlTrLCeOQF%252F14.png%3Falt%3Dmedia%26token%3Df3537ced-b334-4066-8158-2aaf426bdbd7&width=768&dpr=4&quality=100&sign=733ac2fe&sv=1)
Select the downloaded ISO disk image.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FgrXISihLtXeGnR1OIQNw%252Fnew1.png%3Falt%3Dmedia%26token%3D2cfa3a15-40d9-47c5-9ff2-37c461853b56&width=768&dpr=4&quality=100&sign=58a48870&sv=1)
"Go to the 'Network' tab.
Set the Connection Type to 'Bridged Adapter'. Click 'OK' to save all the settings you have made.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252Fg769ieyrkn0g2RGueozr%252F15.png%3Falt%3Dmedia%26token%3D85bee37c-4607-4f58-9506-96a51bb35344&width=768&dpr=4&quality=100&sign=b71a0f9&sv=1)
Installantion MikoPBX
Start the created virtual machine.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FdkdXqjfwtTjelUzH35I0%252F17.png%3Falt%3Dmedia%26token%3Dfae686aa-db95-498c-b5cc-28b44e46ee84&width=768&dpr=4&quality=100&sign=4da0cc06&sv=1)
The command interface of the PBX will open. The PBX will start booting.
At this stage, MikoPBX is booting from the optical disc containing the ISO image. This is indicated by the message: 'The system is loaded in Recovery mode'.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FhpaDoUMdSUFltsEj0Qve%252F18.png%3Falt%3Dmedia%26token%3Db1a27df4-a100-4067-8712-7f51897f05a3&width=768&dpr=4&quality=100&sign=77ffc8f9&sv=1)
You can navigate through the menu items using the arrow keys.
To select a menu item, press the Enter key.
Alternatively, you can select a menu item by pressing the corresponding number on the alphanumeric keypad."
Install MikoPBX.
All data on the disk where MikoPBX is being installed will be lost
Click Install.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FGD7YAUsWYcvyieIj6PJ7%252F19.png%3Falt%3Dmedia%26token%3D00734402-f65a-4243-b219-b1ca2e4d1626&width=768&dpr=4&quality=100&sign=d9a1394c&sv=1)
Information about all available disks will be displayed (in this example: sdb, sdc).
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252F8E6ksJzJG3CxEaoRZt91%252F20.png%3Falt%3Dmedia%26token%3D741a48ef-4b52-4c63-aeb7-74a330843aa6&width=768&dpr=4&quality=100&sign=8c12a012&sv=1)
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.
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).
The system will prompt for confirmation. Enter 'y' and press Enter.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FcPwRe39ZbNJON4VDkZmf%252F21.png%3Falt%3Dmedia%26token%3Db52aacf7-b1c7-4457-bf35-25901d72b23a&width=768&dpr=4&quality=100&sign=38593017&sv=1)
After completing the installation, you will be prompted to select a disk for storing call records.
Approximately, 1 hour of conversation takes up 14MB of disk space.
Enter the disk name (in this example, the only available disk is 'cdc') and press Enter.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252Fppn9fPkzBIi3wfbB8n6X%252F22.png%3Falt%3Dmedia%26token%3Dc31d57c8-bb47-43b8-824d-05532901f9a9&width=768&dpr=4&quality=100&sign=23c8cfe6&sv=1)
After the installation is complete, the system will reboot.
MikoPBX will now run from the sdb drive where you installed it.
We will see that the line "The system is loaded in Recovery mode" is missing.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FprmCslr37wYSGkxMjX8s%252F23.png%3Falt%3Dmedia%26token%3Dc59a2a11-d82e-43b2-86b5-11a9117ad2bc&width=768&dpr=4&quality=100&sign=d9d4725e&sv=1)
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.
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FVuH8LObzMFVe7GlZjzV6%252Fnew2.png%3Falt%3Dmedia%26token%3D630c57a4-d084-4266-bc26-7e9dffcc4932&width=768&dpr=4&quality=100&sign=37bfda19&sv=1)
![](https://docs.mikopbx.com/~gitbook/image?url=https%3A%2F%2F835495363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsZ8acWnNlSalIHQjMFu1%252Fuploads%252FqPxOrbTNRZJ8JHIqfpFK%252Fnew3.png%3Falt%3Dmedia%26token%3D8bc43042-f5aa-49c3-82ba-769f0ec00681&width=768&dpr=4&quality=100&sign=f218e97e&sv=1)
The default login and password are "admin" for MikoPBX.
The installation of MikoPBX is now complete.
Last updated