Installation via writing the image to a USB drive (Live USB)

Writing the image to a USB drive

Windows

Before starting the process, format your USB drive with the following parameters:

• File system - FAT32

• Allocation unit size - 8192 bytes

The image will be written using the Rufus utility. You can download it here.

1. After installing the utility, open its interface. In the "Device" section, select your USB drive, click SELECT, and choose the previously downloaded .iso image. Its verification will begin.

1. Once verification is complete, set the following parameters and click START:

• File system - FAT32

• Cluster size - 8192 Bytes

• Quick format - checked

• Create extended label and icon files - uncheck this option

1. In the popup window, select "Write in DD Image mode" and click OK.

1. In the confirmation window warning that all data on the disk will be erased, click OK.'

Wait until the image writing process is complete. When done, you’ll see the message "READY". Then proceed to the section "System installation".

MacOS

1. Connect your USB drive and open the Terminal.

1. Run the following command:

diskutil list

This will display information about all connected disks. Find the one labeled (external, physical) — for example, disk4 (the number may differ on your system). Use its number for the next steps.

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

sudo diskutil eraseDisk FAT32 NONAME MBRFormat /dev/disk4;

Enter your admin password when prompted and wait until formatting completes.

1. Unmount (disconnect) the disk using this 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.iso of=/dev/disk4 bs=1m;

Wait until the writing process is complete. Then proceed to the section "System installation".

Linux

This example uses Ubuntu 24.04 to demonstrate the image writing process.

1. Connect your USB drive and open the Terminal.

1. Run the following command:

lsblk

This will display information about all connected drives. Find your USB drive in the list and remember its name. In our example, it is sdb.

1. Next, format the USB drive with the following command:

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

Enter your admin password when prompted and wait until formatting completes.

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.iso of=/dev/sdb bs=1M

Wait until the writing process is complete. Then proceed to the section "System installation".

System installation

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 is booted in LiveCD mode — indicated by the red message. To install, use the keyboard arrows to navigate to "[8] Install" and press Enter.

1. Select the disk where the system will be installed. Enter its ID (name), for example sdc.

1. Confirm your choice by typing "y" to continue.

1. After installation, you will be asked to select a disk for storing call recordings. Make your choice as before.

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

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