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

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

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.