Installing the system on a USB drive (Bootable USB)

Before starting, download the disk image file with the .raw extension. You can do this here.

Installing the system on a USB drive

Windows

The USB drive must be at least 1 GB in size. All data on the USB drive will be deleted!

This guide uses the balenaEtcher utility. You can download it here.

1. First, format your USB drive with the following parameters:

• File system - FAT32

• Allocation unit size - 8192 bytes

Formatting USB drive

1. Open balenaEtcher. Click "Flash from file" and select the previously downloaded .raw file.

"Flash from file" button

1. Click "Select target".

"Select target" button

1. From the list, select your USB drive. Then click "Select 1".

Selecting the disk for writing

1. Next, click "Flash!"

"Flash!" button

Wait for the process to complete. Then proceed to the section "Booting from USB drive".

Successfully writed image

MacOS

1. Connect your USB drive and open the Terminal.

The USB drive must be at least 1 GB in size. All data on the USB drive will be deleted!

1. Run the following command:

diskutil list

This command displays all connected disks. Look for the disk labeled (external, physical). In our case, it is disk4 (the number may differ on your system). Use this number in the following steps.

List of all available disks

1. Next, format the USB drive using this command:

sudo diskutil eraseDisk FAT32 NONAME MBRFormat /dev/disk4;

All data on the disk will be deleted! Double-check the disk name before formatting!

Enter your administrator password when prompted and wait for the formatting to complete.

Formatting the disk

1. Unmount (disconnect) the disk using the following command:

sudo diskutil unmountDisk /dev/disk4;

unmountDisk command

1. Write the image to the USB drive using this command:

sudo dd if=mikopbx-2024.1.114-x86_64.raw of=/dev/disk4 bs=1m;

Wait for the writing process to complete. Then proceed to the section "Booting from USB drive".

Successfully writed image

Linux

In this example, the image writing process will be demonstrated on Ubuntu 24.04.

1. Connect your USB drive and open the Terminal.

The USB drive must be at least 1 GB in size. All data on the USB drive will be deleted!

1. Run the following command:

lsblk

This command displays information about all connected disks. Find your USB drive in the list and note its name. In our case, it is sdb.

"lsblk" command

1. Next, format the USB drive using this command:

sudo mkfs.vfat -F 32 -n NONAME /dev/sdb

All data on the disk will be deleted! Double-check the disk name before formatting!

Enter your administrator password when prompted and wait for the formatting to complete.

Formatting the disk

1. Unmount (disconnect) the disk using this command:

sudo umount /dev/sdb*

"umount" command

1. Write the image to the USB drive using this command:

sudo dd if=mikopbx-2024.1.114-x86_64.raw of=/dev/sdb bs=1M

Wait for the process to complete. Then proceed to the section "Booting from USB drive".

Successfully writed image

Booting from USB drive

1. Boot from the USB drive. If errors occur (black screen), make sure that:

• Secure Boot - Disabled

• CSM (Compatibility Support Module) - Enabled

Booting from USB drive

1. The system has successfully booted, but no drive is connected for storing call recordings. To connect it, use the arrow keys to navigate to "[6] Data storage" and press Enter.

"[6] Data Storage" section

1. Then select "Mount drive as data storage" to connect the disk.

"Mount drive as data storage" option

1. Select the disk that will be used to store call recordings. Enter its ID (name), for example sdc in our case, and press Enter.

Selecting the disk

1. After this, the system will reboot and will be ready for use and for the first login to the Web interface.

Successfully installed MikoPBX system

To open the Web interface, enter your MikoPBX IP address in your browser’s address bar. Use the default login credentials.

Default credentials for first login to the Web interface:

Login: admin Password: admin