> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws.md).

# Cloud - AWS

Launch a ProSBC instance on Amazon Web Services from an Amazon Machine Image (AMI), step by step through the EC2 console.

### Introduction

This article provides guidance for people launching an instance of *ProSBC* using an Amazon Machine Image (AMI) on Amazon Web Service (AWS).

### Instantiate a ProSBC

* After logging in your Amazon account, click on “EC2” in the main AWS console:

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FwtUbvW27VPcjcGGzbFQA%2F1.jpg?alt=media&#x26;token=8c61bebe-2680-4dd6-bd1d-211e5c14b1ea" alt=""><figcaption></figcaption></figure>

* Be sure that you are in the correct region. Consult TelcoBridges if you are unsure which region to locate the AMI. On the left menu click on “AMIs” and select “Private image” to locate ProSBC AMI:

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FTbOShdW4iUFYSciF4cF3%2F2.jpg?alt=media&#x26;token=db119ac5-5419-49cb-87ac-ded7a548f01f" alt=""><figcaption></figcaption></figure>

* Launch the ProSBC image.

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FF9YvYvdVdmgL7yGNIAHW%2F3.jpg?alt=media&#x26;token=b95ce931-bdb7-42a2-9ad5-969cf6cfc30d" alt=""><figcaption></figcaption></figure>

* Name the instance and add any necessary tag

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2Ft02xJIxbh4Mvv7mcjkbr%2F4.jpg?alt=media&#x26;token=3335beff-0672-4288-91d1-c3d537d30cba" alt=""><figcaption></figcaption></figure>

* Select the instance type and its resources.

  The smallest supported instance type is:

  * m5.large / m6i.large / m7i.large / m8i.large (2 vCPU, 8 GiB)

  The recommended instance type is:

  * m7i.xlarge or newer (4 vCPU, 16 GiB)
* Supported instance families:
  * **m5** — Intel Xeon Platinum
  * **m6i** — 3rd generation Intel Xeon
  * **m7i** — 4th generation Intel Xeon
  * **m8i** — Intel Xeon 6
* Supported sizes: `.large` through `.12xlarge` in each of the four families. Instance types outside these families are not supported.
* This is the list of approximate performances by instance size. Results may vary according to configuration.

<table><thead><tr><th width="255.7576904296875">Instance size</th><th width="110">AWS CPU cores</th><th width="110">Calls per second (cps)</th><th width="140">Sessions with RTP anchoring</th><th width="160">Sessions with Media bypass</th></tr></thead><tbody><tr><td><code>.large</code> (2 vCPU, 8 GB)</td><td>2</td><td>50</td><td>400</td><td>32,000</td></tr><tr><td><code>.xlarge</code> (4 vCPU, 16 GB)</td><td>4</td><td>215</td><td>750</td><td>60,000</td></tr><tr><td><code>.2xlarge</code> (8 vCPU, 32 GB)</td><td>8</td><td>575</td><td>2,000</td><td>60,000</td></tr><tr><td><code>.4xlarge</code> (16 vCPU, 64 GB)</td><td>16</td><td>650</td><td>4,000</td><td>60,000</td></tr><tr><td><code>.12xlarge</code> (48 vCPU, 192 GB)</td><td>48</td><td>650</td><td>4,800</td><td>60,000</td></tr></tbody></table>

{% hint style="info" %}
These figures were measured on m5. The equivalent m6i, m7i and m8i sizes have the same vCPU and memory allocation and meet or exceed them.
{% endhint %}

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2F8bR4AHJWRumFCaKwIevb%2F5.jpg?alt=media&#x26;token=a8d85ca0-dc31-4ab4-a452-ae1c01365e6a" alt=""><figcaption></figcaption></figure>

* For later access to the ProSBC SSH console you will need to select a Key Pair to secure the login. You can also create a new Key Pair in case you need.

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FEVFn2bKWxk4VlNX4KnQg%2F6.jpg?alt=media&#x26;token=74d2f50f-e835-4653-93c2-73896c06dd9f" alt=""><figcaption></figcaption></figure>

* In "Networking Settings" select "Create security group". We recommend that you simply open "All Traffic" on your own IP addresses to whitelist it in AWS firewall on "Source", once all your IPs are listed click on "Add security group rule": (note that the SBC contains its own internal firewall)

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FVzF27lhPnmdRKqUXQTUR%2F7.jpg?alt=media&#x26;token=d3ebc019-691d-42d8-83a0-370aaceaa668" alt=""><figcaption></figcaption></figure>

* In "Configure Storage" change the Volume Size to 40Gb and select volume type to GP2.

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FblUrvwYr2anATasQZX7l%2F8.jpg?alt=media&#x26;token=4715b20f-0a0e-4641-9c14-45d3975ab8b2" alt=""><figcaption></figcaption></figure>

* Finally review the summary of your instance and start the creation process clicking on "Launch Instance". Be aware, from this moment you will be billed by Amazon for the instance resources:

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FVi9VzfCznWhOqq5RD2yk%2F9.jpg?alt=media&#x26;token=8bdeedfb-31f9-44d4-9b09-51bef43d5e63" alt=""><figcaption></figcaption></figure>

* You should receive the confirmation of the launching process, this process will take some minutes until the instance is available, You can view your instance clicking on “View Instances”:

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FsZiNPElLEcI00UBcb223%2F10.jpg?alt=media&#x26;token=3b0b726a-c434-425a-b5f9-47bb09f926ea" alt=""><figcaption></figcaption></figure>

* After a few minutes your instance should be running and available to be configured:

<figure><img src="https://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FpDMQbQxzdrs8TCbqItRG%2F11.jpg?alt=media&#x26;token=dbde81fb-e255-4a35-98cf-b7cfb119cd6f" alt=""><figcaption></figcaption></figure>

<br>

#### Optional: Elastic IP Creation section

* AWS will automatically provide and allocate a dynamic public IP to your instance, this will allow you to access from the IPs you whitelisted before to the Public IP allocated to your instance. For ProSBC servers the purpose is to interact with other SIP elements as part of a VoIP cloud telecom infrastructure, TelcoBridges strongly recommends associating an Elastic IP to your instance, which is, in short, to associate a fixed public IP to your SBC. For more information about how to associate an Elastic IP to your instance please check the official documentation in AWS [here](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html).

### Enhanced networking

All supported instance types use the **Elastic Network Adapter (ENA)**, and enhanced networking is **enabled by default**. No action is required before you configure the ProSBC.

{% hint style="info" %}
Enhanced networking must be active for tbrouter to reach the network devices on the VM. On the supported instance types it always is.
{% endhint %}

#### Verifying enhanced networking (optional)

If you want to confirm it on an existing instance:

1. Install the [AWS CLI](https://aws.amazon.com/cli/).
2. On the AWS web portal, click your account name and choose "Security Credentials", expand the "Access keys" section and create a new key. You will need the AWSAccessKeyId and AWSSecretKey.
3. Run `aws configure` and paste the access key ID and secret key that you previously obtained, along with your default region.
4. Run the following, replacing the example instance ID with your own AWS instance ID:

```
 aws ec2 describe-instances --instance-ids i-0123456789abcdef1 --query "Reservations[].Instances[].EnaSupport"
```

A result of `true` confirms that enhanced networking is enabled.

### Accessing the ProSBC

#### Accessing the ProSBC web portal

* Open a web browser to the management IP of the ProSBC, on port 12358. Example if your Instance public IP address is 35.183.126.193, the URL would be:\
  [http://35.183.126.193:12358](http://35.183.126.193:12358/)

<br>

You should get to the ProSBC Configuration Wizard\
![](https://docs.telcobridges.com/w/images/thumb/0/01/AWS_TSBC_WebPortal_Configuration_wizard.jpg/700px-AWS_TSBC_WebPortal_Configuration_wizard.jpg)

<br>

Take note that it may take a while for the ProSBC system to make the Web Portal available (around 3-5 minutes).

* From here, you can go to [Web Portal Initial Configuration Guide](/initial-installation/2.-initial-configuration/initial-setup.md) to continue the installation.

### Installing AWS Instance with CloudFormation Template

AWS CloudFormation is a service that helps you model and set up your AWS resources so that you can spend less time managing those resources and more time focusing on your applications that run in AWS. Telcobridge created a CloudFormation template to reduce the time spent on ProSBC AWS installation. Click on the following link to the ProSBC CloudFormation installation: [ProSBCAWS CloudFormation Installation](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/cloud-formation-installation.md)

### Upgrading the instance type

You can upgrade the instance type in AWS based on your requirements. Click on the following link for instance type upgrade [ProSBC AWS Intance Upgrade](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/instance-upgrade.md)

### Adding more interfaces to ProSBC in AWS

You can add more interfaces to ProSBC in AWS based on your requirements. Click on the following link for how to add an interface [ProSBC AWS Additional Interface](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/aws-additional-interface.md)

### Web Portal Initial Configuration

Click on the following link to pursue installation from the web portal: [ProSBC Initial Configuration](/initial-installation/2.-initial-configuration.md)

### AWS using NAT

Since the AWS instance is behind NAT, you must adjust the NAT settings for the SBC: [IP Network Settings](/configuration-details/configuration-by-web-portal-category/ip-network-settings.md)

### Troubleshooting

* [Installation troubleshooting](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/aws-installation-troubleshooting.md)
* [Recovering an Elastic IP address](/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws/recovering-an-elastic-ip-address.md)

### External References

* [Accessing device with SSH and private key using putty](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-to-linux-instance.html)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/initial-installation/1.-instructions-by-platform/cloud-installation/cloud-aws.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.