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

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

## 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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FUVX9HawvZKrjZUMSVNpo%2FformatFlashUSB.png?alt=media&#x26;token=c3c34f99-f522-4aea-80ea-36fd954c9061" alt=""><figcaption><p>Formatting the disk</p></figcaption></figure>

The image will be written using the Rufus utility. You can download it [here](https://rufus.ie/en/).

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FKjUBRmS8c9n8aMVcAD0S%2FrufusMainMenu.png?alt=media&#x26;token=0d477122-9af0-4cc6-8c39-fe5cb411af22" alt="" width="285"><figcaption><p>Rufus main page</p></figcaption></figure>

{% hint style="danger" %}
The USB drive size must be at least 1 GB. **All data on the USB drive will be deleted!**
{% endhint %}

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](https://www.mikopbx.com/download/). Its verification will begin.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FNNMUKH6a35rMo98rsHGq%2FrefusSecletedDevice%26Image.png?alt=media&#x26;token=fdf78c6c-3408-4c93-b3d9-d0cca94879c6" alt="" width="285"><figcaption><p>Selected image and disk</p></figcaption></figure>

2. 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**

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FpdCmKQ0kXn1xSUaKm2bi%2FrufusStartButton.png?alt=media&#x26;token=0dbfc190-3007-4c3a-9f56-4e91a2ac89d1" alt="" width="285"><figcaption><p>Starting the image writing process</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FlZvQtXEN9pkoKEF804sw%2FrufusWriteInDDmodeNew.png?alt=media&#x26;token=87b10571-50b6-4585-a32a-c8abd4afd7fa" alt="" width="314"><figcaption><p>"Write in DD image mode" option</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FTJV4Qqx7MTDQpQmvi6ge%2FrufusConfirmFormatNew.png?alt=media&#x26;token=a984316a-8365-4933-a3de-4323ac618efc" alt="" width="285"><figcaption><p>Disk format confirmation</p></figcaption></figure>

Wait until the image writing process is complete. When done, you’ll see the message "READY".\
Then proceed to the section ["System installation"](#system-installation).

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FqCKepgqbqCfXIOlnpvGN%2FrufusImageReadyNew.png?alt=media&#x26;token=8f334284-b9f8-49e0-9d00-e45d01e502db" alt="" width="285"><figcaption><p>Successfully writed image</p></figcaption></figure>

### MacOS

1. Connect your USB drive and open the Terminal.

{% hint style="danger" %}
The USB drive size must be at least 1 GB. **All data on the USB drive will be deleted!**
{% endhint %}

2. Run the following command:

```bash
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.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FBK1agj77XpXFzw0zJS8z%2FdiskutilListNew.png?alt=media&#x26;token=6f1c6411-4c4b-4a38-b678-4bdfecd8d86e" alt=""><figcaption><p>List of all available disks</p></figcaption></figure>

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

```bash
sudo diskutil eraseDisk FAT32 NONAME MBRFormat /dev/disk4;
```

{% hint style="danger" %}
**All data on the disk will be deleted!** Double-check the disk name before formatting!
{% endhint %}

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FV7UgkwDSERYWi9CCbWEZ%2FeraseDiskUtil.png?alt=media&#x26;token=641b7421-63b6-4c1e-8c8e-eb8c9cc01385" alt=""><figcaption><p>Formatting the disk</p></figcaption></figure>

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

```bash
sudo diskutil unmountDisk /dev/disk4;
```

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FEX3oPScX4xKq6vrDw5lO%2Funmount.png?alt=media&#x26;token=8ce5628a-3be5-4789-a7c4-7bb2f47f2124" alt=""><figcaption><p>unmountDisk command</p></figcaption></figure>

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

```bash
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"](#system-installation).

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FCA3VyIS7X0ZKetwntY26%2FddWrite.png?alt=media&#x26;token=102efe4d-2fda-4493-b9ed-a2528d7045cd" alt=""><figcaption><p>Successfully writed image</p></figcaption></figure>

### Linux

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

1. Connect your USB drive and open the Terminal.

{% hint style="danger" %}
The USB drive size must be at least 1 GB. **All data on the USB drive will be deleted!**
{% endhint %}

2. Run the following command:

```bash
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**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fs1BOv4nfoTO7gloDkc2J%2FlsblkCommand.png?alt=media&#x26;token=21fb55bc-00b6-44c5-9cb9-cc14c1bfa152" alt=""><figcaption><p>lsblk command</p></figcaption></figure>

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

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

{% hint style="danger" %}
**All data on the disk will be deleted!** Double-check the disk name before formatting!
{% endhint %}

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FNuUFOaLo5KpxQoXVDY6t%2FformatDisk(mkfs.vfat).png?alt=media&#x26;token=dc51ff4c-4aa8-4ddf-8e12-ed2d27ccc055" alt=""><figcaption><p>Disk fromatting</p></figcaption></figure>

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

```bash
sudo umount /dev/sdb*
```

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FRVi5Jt2QBkevPNInfHuS%2FumountCommand.png?alt=media&#x26;token=3d9b9294-d631-432f-87c1-e953d4486d84" alt=""><figcaption><p>umount command</p></figcaption></figure>

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

```bash
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).

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FJG13DSUHukKqrtZYR3b1%2FsuccessfulWritedImage(Ubuntu).png?alt=media&#x26;token=f6ffcebb-67b4-4b27-825b-0533dda2dd66" alt=""><figcaption><p>Successfully writed image</p></figcaption></figure>

## System installation

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

* **Secure Boot** - Disabled
* **CSM (Compatibility Support Module)** - Enabled

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Foj0arBet5IBp4SC94EyZ%2FMikoPBXSystemStartScreen.jpg?alt=media&#x26;token=b27a751d-4f5e-48bc-ab95-627932be5125" alt=""><figcaption><p>System booted from LiveUSB device</p></figcaption></figure>

2. 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**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FyJiwXingSAjtjIcRqzox%2FMikoPBXSystemInstallSec.jpg?alt=media&#x26;token=1a6afa2c-2a5b-4d26-ab75-3ad089a2f3f1" alt=""><figcaption><p>Section "[8] Install"</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FM8ZqqrMR9ytLVQHkiSh9%2FMikoPBXSystemChooseSysDisk.jpg?alt=media&#x26;token=f12d57c1-9b4e-4f11-9473-fd3a45ad9353" alt=""><figcaption><p>Selecting the system disk</p></figcaption></figure>

4. Confirm your choice by typing "**y**" to continue.

{% hint style="danger" %}
**All data** on the selected disk will be erased!
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FWrfUZNtzSOoJUnlgxgh7%2FMikoPBXSystemConfirmChoice.jpg?alt=media&#x26;token=ab622a99-6464-491d-99ee-f60d7e424e14" alt=""><figcaption><p>Confirmation of your choice</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FEx135GbmZ5L5is0Z9isM%2FMikoPBXSystemChooseStorageDisk.jpg?alt=media&#x26;token=73b157f4-418f-4de7-8d7b-e4d844326253" alt=""><figcaption><p>Selecting the records storage disk</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fa50PZjYalYDeKHdaw6CN%2FMikoPBXSystemReady.jpg?alt=media&#x26;token=2c7cd4f0-1bec-4fe8-8832-11fd3305b6b2" alt=""><figcaption><p>Successfully installed system</p></figcaption></figure>

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

{% hint style="success" %}
Default credentials for first login to the Web interface:

Login: admin\
Password: admin
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FiX2NwOulUj1jV0IjDFpW%2FMikoPBXweb.jpg?alt=media&#x26;token=263b7061-e0d2-4e15-88e6-a29cf5653c96" alt=""><figcaption></figcaption></figure>