# Installation via writing the image to a USB drive (Live USB) {% embed url="" %} ## 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](https://rufus.ie/en/).

{% 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.

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

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

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

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

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.

4. Unmount (disconnect) the disk using this command: ```bash sudo diskutil unmountDisk /dev/disk4; ```

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

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

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.

4. Unmount (disconnect) the disk using this command: ```bash sudo umount /dev/sdb* ```

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

## System installation 1. Boot from the USB drive.\ If errors occur (black screen), make sure that: * **Secure Boot** - Disabled * **CSM (Compatibility Support Module)** - Enabled

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

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

4. Confirm your choice by typing "**y**" to continue. {% hint style="danger" %} **All data** on the selected disk will be erased! {% endhint %}

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

6. 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. {% hint style="success" %} Default credentials for first login to the Web interface: Login: admin\ Password: admin {% endhint %}

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mikopbx.com/mikopbx/english/setup/bare-metal/live-usb.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.