Digital Ocean

Installing MikoPBX using the DigitalOcean Cloud Platform

This guide applies to MikoPBX version 2024.2.111 and newer!

In this guide, we will perform a step-by-step installation of MikoPBX using the DigitalOcean cloud platform.

Before beginning, you need to copy the download link for the latest .raw MikoPBX image. You can find these on MikoPBX's GitHub releases.

Uploading the Image to DigitalOcean

1. Go to "Manage" → "Backups & Snapshots":

Section "Backups & Snapshots"

1. Go to "Custom Images" → "Import via URL":

"Import via URL"

1. Paste the link to the .raw disk image file you copied earlier.

2. Enter a name for the image, select the region where it will be uploaded (this should match the region of your future virtual machine), and choose "Unknown" as the operating system type.

   Click "Upload image".

Image parameters

Wait for the image upload to complete.

Creating a Virtual Machine in the Cloud

1. Go to DigitalOcean’s main page:

DigitalOcean’s main page

1. To create a new virtual machine (Droplet), go to "Create" → "Droplets":

Creating a droplet

1. Select a region and datacenter for your virtual machine:

VM Parameters #1

1. Next, choose the previously uploaded image and configuration for your virtual machine:

VM Parameters #2

1. Go to the "Additional Storage" tab. Here, you can add a second disk that will be used for call recordings. To do this, click "Add volume" and specify the parameters for the new disk.

We recommend a minimum size of 50GB for the call recordings disk.

"Additional Storage" section

1. Go to "Choose authentication method." Here, you need to select "SSH Key" and add the key pair for SSH authentication. For more information on generating SSH keys, see:

• Windows

• MacOS/Linux

Authentication Methods

1. Click "Create Droplet."

Connecting to the Console and First Login to the Web Interface

Connecting via DigitalOcean Console

1. Go to the page of the newly created Droplet. Wait for it to start. Then connect via the built-in DigitalOcean console (shown in the screenshot).

Console in the Digital Ocean interface

1. After the system boots, open the web interface using the external IP address shown in the console (external).

MikoPBX IP-adress

1. Paste the machine’s IP address into your browser’s address bar. When you reach the MikoPBX login page, use the following credentials:

• Username: admin

• Password: The Droplet ID, which you can find in the browser’s address bar:

Droplet ID

Connecting via SSH

1. To connect via SSH, follow these instructions. This example uses PowerShell (Windows).

The default login for SSH on a DigitalOcean VM is do-user.

1. Open PowerShell and run the following command:

ssh -i C:\Users\<Username>\.ssh\id_ed25519 do-user@mikopbxipadress

Adjust:

1. C:\Users\<Username>\.ssh\id_ed25519 to the path of your local SSH key.

2. do-user if you changed the root user during VM creation.

3. mikopbxipadress to the IP address of your station (IPv4 in the VM management interface).

Command for SSH connection

After pressing Enter, you will be authenticated via SSH and arrive at the MikoPBX console menu.