Alibaba Cloud

Installing MikoPBX using the Alibaba Cloud platform

This guide applies to MikoPBX version 2024.2.135 and later!

This step-by-step guide will walk you through installing MikoPBX on the Alibaba Cloud platform.

Before starting, download the latest .raw MikoPBX image from MikoPBX’s GitHub releases.

Uploading the Image to Alibaba Cloud

Creating a Bucket

First, create a bucket for storing your image. Go to the OSS Management Console (link).

1. Go to Buckets.

Buckets section

1. Click Create Bucket:

"Create Bucket" button

1. Specify the following:

• Bucket name – a custom name for your storage.

• Region – pick the region where your image will be stored.

The bucket region for your image must match the region of your future virtual machine!

Click OK.

Bucket parameters

1. Go to your newly created bucket by clicking its name in the Buckets section:

Bucket name

1. Click Upload object and upload the previously downloaded .raw disk image file (leave other parameters at default).

"Upload Object" button

1. Once the disk image file is uploaded, copy its link. Click View Details to the right of the file name; in the opened menu, copy the URL field.

URL of the uploaded file

Creating the Image

1. Return to the ECS Console (link) and go to Images.

"Images" section

1. Click Import Image:

"Import Image" Button

1. Select Linux Operating System and click Next.

2. Enter/select the following image parameters:

   • Image File URL – Paste the link to the disk image file you uploaded.

   • Image Name – A custom, unique name for your image.

   • OS Type – Linux

   • OS Version – Others Linux

   • Architecture – 64-bit OS

   • Uncheck "Check After Import"

Click OK to create the image. Wait until the process finishes (the Status will show Available).

Image Parameters

Creating an SSH Key Pair

Next, create and add an SSH key pair in Alibaba Cloud.

1. In the ECS Console, go to Network Security → Key Pairs:

"Key Pairs" section

1. Click Create SSH Key Pair:

"Create SSH Key Pair" button

1. Generate an SSH key pair. For details on how to generate a key pair, see this guide. Fill in the required parameters:

• Name – A custom name for your key pair.

• Creation Mode – Import

• Public Key – Paste your public key, generated earlier.

• Resource Group – Choose your resource group.

Click OK to create the key pair in the cloud.

SSH Key Pair Parameters

Creating a Security Group

Before creating the virtual machine, you must set up a security group (firewall).

1. Go to Network & Security → Security Groups:

"Security Groups" Section

1. Click Create Security Group:

"Create Security Group" button

1. Specify the following security group parameters:

• Security Group – A custom name for your security group.

• Network – Your selected network. If it doesn’t exist yet, click "Create VPC" to the right.

• Security Group – Basic Security Group.

• Resource Group – Your resource group.

• Allow all inbound connections (see example below). Outbound is allowed by default.

Be sure to configure the firewall within MikoPBX itself as soon as possible after creating the virtual machine. Read more about that here.

Click Create Security Group.

Security Group parameters

Creating the Virtual Machine

1. Go to Instances & Images → Instances:

"Instances" section

1. Click Create Instance to create a new virtual machine:

"Create Instance" button

1. Select your VM parameters:

• Billing Method – Choose how you’ll pay for the VM.

• Region, Network, and Zone – Select the region and zone to match your needs.

• Instance – Pick a configuration for your VM.

VM Parameters №1

1. Configure additional VM parameters:

• Image – Custom Images → Choose the previously imported image.

• Storage – Select the type and size of the System Disk (20 GB is the minimum for Alibaba Cloud).

• Add a second disk by clicking Add Data Disk, specifying its type and size.

We recommend a minimum of 50GB for call recordings.In this guide we use 30GB as an example.

VM Parameters №2

1. Choose the network parameters for your VM. The security group created earlier will be assigned automatically:

VM Parameters №3

1. Click Create Order.

"Create Order" button

Connecting to the MikoPBX Console

In the Instances section, open the newly created VM by clicking its name.

VM's name

Connecting via Built-in Cloud Console

1. Click Connect.

"Connect" button

1. Select VNC. A new tab will open in your browser with console access.

VNC Console

Connecting via SSH

For more information on SSH connections, refer to this set of articles. In this guide, we demonstrate SSH access via PowerShell.

Enter the following command to connect via SSH:

ssh -i C:\Users\username\.ssh\id_ed25519 root@ip-adress

Replace:

• C:\Users\username\.ssh\id_ed25519 with the path to your SSH key,

• root if you changed the default user when creating the VM,

• ip-adress with the external IP address of your MikoPBX instance.

Command for SSH connection

You will then connect via SSH:

SSH Connection

First Login to the Web Interface

On the VM’s main page, you’ll see important parameters for logging into the MikoPBX web interface.

Authorization Parameters for the WEB-interface

Paste the IP address into your browser’s address bar to access the MikoPBX web interface login page.

Login credentials:

• Username: admin

• Password: Your Virtual Machine’s ID

MikoPBX WEB-interface