Sign in to the service Amazon Web Services https://aws.amazon.com

To follow the instructions, install the Amazon Command Line Utility by opening Terminal and entering the following command

curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" 
sudo installer -pkg AWSCLIV2.pkg -target /

Let's get started with the setup

Copying access keys

1. Go to your account

2. From the dropdown menu, select Security credentials

If you don't have an access key, do the following

1. Under the Access keys table, select Create access key

2. Copy the Access key and Secret access key

If you already have an access key, simply copy the Access key and Secret access key

Creating a bucket

1. Open Services / Storage / S3

2. On the tab select Create bucket

3. Enter a unique bucket name

1. Use default values for other fields

2. After entering the values, click Create bucket

1. Open the created bucket and select Upload

2. On the opened tab select Add files

3. Upload the file from the MikoPBX distribution with the .raw extension

4. Click Upload

5. Wait for the file to finish uploading

Adding permissions and attaching policies

If not done previously for this cloud

1. Create a separate folder for files on your computer

2. Create a file named trust-policy.json in the folder

   1. Open Terminal and navigate to the created folder

   2. Run the command vi trust-policy.json

   3. Enter editing mode by pressing i and paste the text

   4. Press ESC and type :wq to save the file

vi trust-policy.json

{
"Version": "2012-10-17",
    "Statement":
    [
        {
            "Effect": "Allow",
            "Principal": { "Service": "vmie.amazonaws.com" },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals":{"sts:Externalid": "vmimport"}
            }
        }
    ]
}

1. Similarly, create a file named role-policy.json and change the bucket name value in the text to the name of your created bucket

1. Similarly, create a file named import-image.sh, change the DEFAULT_BUCKET parameter value to the name of your created bucket and the DEFAULT_IMAGE parameter value to the name of the image uploaded to the bucket

1. Run the command aws configure, specify the region and copied Access key and Secret access key

aws configure

1. Run the command

aws iam create-role --role-name vmimport --assume-role-policy-document "file://trust-policy.json"

1. Run the command

aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document "file://role-policy.json"

1. Run the command

sh import-image.sh

If the command executes successfully, a unique AMI identifier will be generated

Creating a virtual machine

1. Open Services / Compute / EC2 and navigate to Images / AMIs

2. Select the created image and click Launch an instance from AMI to create a virtual machine

1. Enter the virtual machine name, for example mikopbx-vm

1. Specify the instance type - t3.micro

If you have an SSH key

1. Specify the SSH key in the Key pair field

If you don't have an SSH key

1. Select Create new key pair and specify the key pair name, for example mikopbx_key

Follow the instructions further

1. In the Network settings section, check Allow SSH traffic and Allow HTTPS traffic

1. If necessary, change the size of the storage disk in Configure storage, default size is 50Gb

1. For other fields use default values

2. Click Launch instance

Starting MikoPBX

1. Go to the created virtual machine mikopbx-vm

2. On the opened tab, select Connect / EC2 serial console, wait for the system to fully load until the authentication parameters are displayed

1. Copy the external address of the created virtual machine and enter it in the browser's address bar

2. Use the login and password provided in EC2 serial console for login

Sign in to the service Amazon Web Services https://aws.amazon.com

MikoPBX in AWS Marketplace: https://aws.amazon.com/marketplace/pp/prodview-ota6fb2tftuhw

Let's get started with the setup

Creating a virtual machine

1. Open Services / Compute / EC2 and navigate to Images / AMI Catalog

2. In the open tab enter MikoPBX in the search bar

3. In the AWS Marketplace AMIs section select the MikoPBX image by clicking the Select button

4. On the opened tab click Subscribe now

5. Click the Launch an instance from AMI button to create a virtual machine

1. Enter the virtual machine name, for example mikopbx-vm

If you have an SSH key

1. Specify the SSH key in the Key pair field

If you don't have an SSH key

1. Select Create new key pair and specify the key pair name, for example mikopbx_key

Follow the instructions further

1. If necessary, change the size of the storage disk in Configure storage, default size is 50Gb

1. Under Network settings, all required Firewall rules are configured automatically

1. For other fields use default values

2. Click Launch instance

Starting MikoPBX

1. Go to the created virtual machine mikopbx-vm

2. On the opened tab, select Connect / EC2 serial console, wait for the system to fully load until the authentication parameters are displayed

1. Copy the external address of the created virtual machine and enter it in the browser's address bar

2. Use the login and password provided in EC2 serial console for login

Installing MikoPBX in Google Cloud can be done in two ways: using an image from the Google Cloud Marketplace or from an image based on a file uploaded from the MikoPBX distribution. The first method provides quick and easy deployment of the standard version of MikoPBX, while the second is suitable for intermediate releases.

The simplest way to install MikoPBX is by deploying a ready-made image from the AWS Marketplace. If you wish to launch a custom version of MikoPBX, please refer to the detailed instructions where we describe step-by-step how to create an AMI image from any MikoPBX distribution.

Log in to the platform at

MikoPBX on Google Cloud Marketplace:

Let's start with the setup

Adding roles to a Service account

If you have a service account, check if it has the necessary roles, and add them if needed

If you do not have a service account, create one and add the necessary roles

1. Open the Navigation menu / Products & solutions / Management / IAM & Admin

2. Go to the Service accounts tab and click on CREATE SERVICE ACCOUNT

3. Enter a name for the service account, for example mikopbx-service-account

4. Click the CREATE AND CONTINUE button

1. Add the roles Cloud Infrastructure Manager Agent, Compute Admin, Compute Network Admin, Service Account User

1. Click the DONE button

Creating a virtual machine

1. Open the Marketplace and enter MikoPBX in the search bar

3. On the opened tab select LAUNCH

1. In the Deployment name field, enter a name, for example mikopbx-vm

2. In the Deployment Service Account section, check the Existing account option and select the previously created service account

1. If necessary, change the size of the data storage disk in the Data Storage section. By default, its size is 50 GB

1. Under Networking, all required Firewall rules are configured automatically

1. For other fields, use the default values

2. After entering the values, click the DEPLOY button

Starting MikoPBX

1. Open the Compute Engine tab and go to the Virtual machines / VM Instance section

2. Go to the created virtual machine mikopbx-vm-mikopbx-vm

3. On the opened tab, go to Logs / Serial port 1 (console)

1. Copy the external address of the created virtual machine and enter it in the browser address bar

2. Use the login and password provided in Serial port 1 (console) to log in

First, log in to the Microsoft Azure portal https://portal.azure.com/

Let's proceed with the setup.

Creating a resource group

1. Open Menu / All services / General / Resource groups

2. In the Resource groups tab, select Create

3. Enter the group name, for example MikoPBX_group

4. Use default values for other fields

5. After entering the values, click the Review + create button, then the Create button

Creating a storage account

1. Open Menu / All services / Analyze and transform data / Storage accounts

2. In the Storage accounts tab, select Create

3. Specify the created resource group MikoPBX_group

4. Enter the storage account name, for example pbximgs

5. Use default values for other fields

6. After entering the values, click the Review + create button, then the Create button

Configuring the created storage account

1. Go to the card of the created storage account pbximgs

2. In the opened tab, go to the Data storage / Containers

3. Add a new container

4. Enter the container name, for example imgs

5. Click the Create button

1. Open the created container imgs

2. In the opened tab, select Upload

3. Select a file from the MikoPBX distribution with the .vhd extension

4. Click the Upload button

Creating an image

1. Open Menu / All services / Compute / Images

2. In the Images tab, select Create, let's create a new image based on the uploaded *.vhd file

3. Specify the resource group MikoPBX_group

4. Enter a unique name for the image, for example MikoPBX_Azure

1. Specify the OS type - Linux

2. Specify the generation of virtual machines - Gen 1

3. Select the blob storage object by clicking Browse, Browse / pbximgs / imgs / *.vhd

4. Specify the account type - Standard HDD

5. Use default values for other fields

6. After entering the values, click the Review + create button, then the Create button

Creating a virtual machine

1. Open Menu / All services / Compute / Virtual machines

2. In the Virtual machines tab, select Create / Azure virtual machine

3. Specify the resource group MikoPBX_group

4. Enter the virtual machine name, for example MikoPBX-vm

1. Choose the previously created image, See all images / Other items / My images / MikoPBX_Azure

2. Specify the machine size (combination of CPU / RAM to be at least 1GB / HDD parameters)

1. Specify the username for the administrator account

If you have an SSH key, do the following

1. Select the source of the SSH public key - Use existing public key

2. Specify it in the SSH public key field

If you do not have an SSH key, do the following

1. Select the source of the SSH public key - Generate new key pair

2. Specify the key pair name, for example mikopbx_key

Continue with the following instructions:

1. In the license type field, specify Other

2. Use default values for the other fields

1. Go to the Disks tab

2. Specify the OS disk type

3. Check the Delete with VM checkbox

1. Create a new data disk

2. Specify the disk size to be at least 50GB

3. Use default values for the other fields, click OK

1. After entering the values, click the Review + create button, then click Create

Configuring ports for incoming connections

1. Open the virtual machine you created and go to Networking / Network settings / Rules

2. In the tab, choose Create inbound port rule

3. Specify the destination port ranges - 0 - 65535

4. Choose the protocol TCP

1. Specify a name, for example TCP

2. Use default values for the other fields

3. After entering the values, click the Add button

1. Similarly, create a rule for UDP. Specify the destination port ranges - 0 - 65535, protocol UDP, and name

Starting MikoPBX

1. Open the virtual machine you created and go to the Connect section

2. In the drop-down menu under More ways to connect, select Serial console

1. Copy the external address of the created virtual machine and enter it in the browser's address bar

2. For login use the login and password provided in Serial console

Authorize on the platform https://console.cloud.google.com/

Let's start configuring

Creating storage

1. Open Navigation menu / Products & solutions / Storage / Cloud Storage

2. On the Cloud Storage tab select Create

3. Enter the storage name, for example miko-images

4. Use default values for other fields

5. After entering the values, click the Create button

1. Open the created miko-images storage

2. On the opened tab select UPLOAD FILES

3. Upload the file from the MikoPBX distribution with the .vhd extension

4. Wait for the file upload to complete

Connecting Cloud Build API

1. Open Navigation menu / APIs & Services / Library / Google Enterprise API / Cloud Build API

2. On the opened tab select ENABLE

Connecting Compute Engine API

1. Open Navigation menu / APIs & Services / Library / Google Enterprise API / Compute Engine API

2. On the opened tab select ENABLE

Creating an image

1. Open Navigation menu / Products & solutions / Compute / Compute Engine

2. Go to the Storage / Images section

3. Select CREATE IMAGE to create a new image

4. Enter the image name, for example mikopbx-new-image

5. Specify the source type - Virtual disk (VMDK, VHD)

6. Select Virtual disk file under the BROWSE link, Browse / miko-images / .vhd

7. Uncheck the Install guest packages checkbox

8. In the Operating system on virtual disk field specify - No operating system. Data only.

9. Use default values for other fields

10. After entering the values, click the Create button and wait for the image creation to complete

Creating a virtual machine

1. In the Compute Engine tab go to the Virtual machines / VM Instance section

2. Select CREATE INSTANCE

3. Enter the virtual machine name, for example mikopbx-vm

1. In the Machine configuration / General purpose table select Series - N1

1. In the Machine type section choose Shared-core / f1-micro from the dropdown menu

1. In the Boot disk section select CHANGE

2. On the opened tab go to CUSTOM IMAGES

3. In the Image field select the previously created mikopbx-new-image

4. Use default values for other fields on the tab

5. Click the SELECT button

1. In the Advanced options / Disks section select ADD NEW DISK

2. On the opened tab enter the disk name for data storage, for example disk-storage-mikopbx

3. Specify the disk size of at least 50GB

4. Use default values for other fields on the tab

5. Click the SAVE button

If you have an SSH key, proceed as follows:

1. In the Advanced options / Security / MANAGE ACCESS section, select ADD ITEM

2. Specify it in the SSH key field

If you don't have an SSH key, proceed directly to step 18

1. Use default values for other fields

2. After entering the values, click the CREATE button

Configuring ports for incoming connections

1. Open Navigation menu / VPC network / Firewall

2. Select CREATE FIREWALL RULE to create a new rule for incoming connections

3. Enter the name of the new rule, for example internal-allow

1. Specify Direction of traffic - Ingress

2. Specify Targets

3. From the Source filter dropdown menu select IPV4 ranges and in the Source IPv4 ranges field enter 0.0.0.0/0

1. In the Protocols and ports section check the TCP (Ports - 0-65535) and UDP (Ports - 0-65535) checkboxes

1. Use default values for other fields

2. After entering the values, click the CREATE button

Starting MikoPBX

1. Open the Compute Engine tab and go to the Virtual machines / VM Instance section

2. Go to the created virtual machine mikopbx-vm

3. On the opened tab navigate to Logs / Serial port 1 (console)

1. Copy the external address of the created virtual machine and enter it in the browser's address bar

2. For login use the login and password provided in Serial port 1 (console)

Авторизуйтесь на платформе https://console.cloud.google.com/

Приступим к настройке

Создание хранилища

1. Откройте Navigation menu / Products & solutions / Storage / Cloud Storage

2. На вкладке Cloud Storage выберите Create

3. Введите имя хранилища, например miko-images

4. Для других полей используйте значения по умолчанию

5. Завершив ввод значений, нажмите кнопку Create

6. Откройте созданное хранилище miko-images

7. На открывшейся вкладке выберите UPLOAD FILES

8. Загрузите файл из дистрибутива MikoPBX с расширением .vhd

9. Дождитесь окончания загрузки файла

Подключение Cloud Build API

1. Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Cloud Build API

2. На открывшейся вкладке выберите ENABLE

Подключение Compute Engine API

1. Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Compute Engine API

2. На открывшейся вкладке выберите ENABLE

Создание образа

1. Откройте Navigation menu / Products & solutions / Compute / Compute Engine

2. Перейдите в раздел Storage / Images

3. Выберите CREATE IMAGE для создания нового образа

4. Введите имя образа (Name), например mikopbx-new-image

5. Укажите тип источника (Source) - Virtual disk (VMDK, VHD)

6. Выберите Virtual disk file по ссылке BROWSE, *Browse / miko-images / .vhd

7. Уберите флажок Install guest packages

8. В поле Operating system on virtual disk укажите - No operating system. Data only.

9. Для других полей используйте значения по умолчанию

10. Завершив ввод значений, нажмите кнопку Create и дождитесь окончания создания образа

Создание виртуальной машины

1. Во вкладке Compute Engine перейдите в раздел Virtual machines / VM Instance

2. Выберите CREATE INSTANCE

3. Введите имя виртуальной машины (Name), например mikopbx-vm

4. В таблице Machine configuration / General purpose ****выберите ****Series - N1

5. В разделе Machine type в выпадающем меню выберите Shared-core / f1-micro

6. В разделе Boot disk выберите CHANGE

7. На открытой вкладке перейдите к CUSTOM IMAGES

8. В поле Image выберите созданный ранее образ mikopbx-new-image

9. Для других полей на вкладке используйте значения по умолчанию

10. Нажмите кнопку SELECT

11. В разделе Firewall ****разрешите HTTP трафик, установите флажок Allow HTTP traffic

12. В разделе Advanced options / Disks выберите ADD NEW DISK

13. На открытой вкладке введите имя диска для хранения данных (Name), например disk-storage-mikopbx

14. Укажите размер диска (Size) не менее 50Гб

15. Для других полей на вкладке используйте значения по умолчанию

16. Нажмите кнопку SAVE

Если у вас есть ключ SSH, выполните следующее

1. В разделе Advanced options / Security / MANAGE ACCESS выберите ADD ITEM

2. Укажите его в поле SSH key

Если у вас есть нет ключа SSH, сразу перейдите к пункту 19

1. Для других полей используйте значения по умолчанию

2. Завершив ввод значений, нажмите кнопку CREATE

Настройка портов для входящих соединений

1. Откройте Navigation menu / VPC network / Firewall

2. Выберите CREATE FIREWALL RULE для создания нового правила для входящего соединения

3. Введите имя нового правила (Name), например http-80

4. Укажите Direction of traffic - Ingress

5. Укажите Targets

6. Из выпадающего меню в поле Source filter выберите IPV4 ranges и в поле Source IPv4 ranges укажите 0.0.0.0/0

7. В разделе Protocols and ports установите флажок TCP и в поле Ports укажите 80

8. Для других полей используйте значения по умолчанию

9. Завершив ввод значений, нажмите кнопку CREATE

10. Аналогично создайте правило для HTTPS. Укажите имя, Direction of traffic - Ingress, Targets, Source filter - IPV4 ranges, Source IPv4 ranges - 0.0.0.0/0, Protocols and ports - TCP, Ports - 443

11. Аналогично создайте правило для SIP сигнализации TCP. Укажите имя, Direction of traffic - Ingress, Targets, Source filter - IPV4 ranges, Source IPv4 ranges - 0.0.0.0/0, Protocols and ports - TCP, Ports - 5060

12. Аналогично создайте правило для SIP сигнализации UDP. Укажите имя, Direction of traffic - Ingress, Targets, Source filter - IPV4 ranges, Source IPv4 ranges - 0.0.0.0/0, Protocols and ports - UDP, Ports - 5060

13. Аналогично создайте правило для передачи звука RTP. Укажите имя, Direction of traffic - Ingress, Targets, Source filter - IPV4 ranges, Source IPv4 ranges - 0.0.0.0/0, Protocols and ports - UDP, Ports - 10000-10200

Запуск АТС MikoPBX

1. Откройте вкладку Compute Engine перейдите в раздел Virtual machines / VM Instance

2. Скопируйте External IP созданной виртуальной машины

3. Введите в строке браузера External IP

4. Откройте созданную виртуальную машину

5. Скопируйте Instance Id - это пароль для входа в АТС по умолчанию

6. Логин для входа по умолчанию - admin