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

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

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

1. Click "Select target".

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

1. Next, click "Flash!"

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

MacOS

1. Connect your USB drive and open the Terminal.

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.

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

sudo diskutil eraseDisk FAT32 NONAME MBRFormat /dev/disk4;

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

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

sudo diskutil unmountDisk /dev/disk4;

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

Linux

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

1. Connect your USB drive and open the Terminal.

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.

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

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

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

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

sudo umount /dev/sdb*

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

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

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.

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

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.

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

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