> 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

Subscribe to ProSBC on AWS Marketplace (BYOL) and launch an instance step by step through the EC2 console.

### Introduction

This article explains how to subscribe to *ProSBC* on AWS Marketplace and launch an instance on Amazon Web Services (AWS).

ProSBC is listed on AWS Marketplace as a **Bring Your Own License (BYOL)** product:

* **AWS Marketplace listing:** [ProSBC on AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-5ffv5kyvr3q66)
* **Software fee on AWS:** none. AWS bills you only for the infrastructure (EC2 instance, storage, data transfer).
* **ProSBC license:** purchased separately from TelcoBridges and uploaded to the ProSBC after the installation. See [Licensing (BYOL)](#licensing-byol) below.

### Subscribe to ProSBC on AWS Marketplace

You only need to subscribe once per AWS account.

1. Log in to your AWS account and open the [ProSBC AWS Marketplace listing](https://aws.amazon.com/marketplace/pp/prodview-5ffv5kyvr3q66).
2. Click **View purchase options**.
3. Review the terms and click **Subscribe**. Because the product is BYOL, there is no software charge from AWS.
4. Wait for the subscription to be confirmed (usually a minute or two), then click **Continue to Configuration**.

### Instantiate a ProSBC

* On the **Configure this software** page, select:

  * **Fulfillment option:** 64-bit (x86) Amazon Machine Image (AMI)
  * **Software version:** the latest ProSBC version, unless TelcoBridges support has asked you to use a specific version
  * **Region:** the AWS region where you want to deploy the ProSBC

  Click **Continue to Launch**.
* On the **Launch this software** page, under **Choose Action**, select **Launch through EC2** and click **Launch**. The EC2 launch wizard opens with the ProSBC AMI already selected.

{% hint style="info" %}
You can also start from the EC2 console: click **Launch instance**, then **Browse more AMIs**, open the **AWS Marketplace AMIs** tab and search for **ProSBC**. Make sure you are in the region where you want to deploy the instance.
{% endhint %}

* 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.xlarge / m6i.xlarge / m7i.xlarge / m8i.xlarge

  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: `.xlarge` 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>.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 AWS bills you for the instance resources. The ProSBC software itself is BYOL and is not billed by AWS:

<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://3811773442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiK3TemJSDhHz3xNMOvvk%2Fuploads%2FKtBqQ0lcbYlefcQfG4m6%2FAWS_TSBC_WebPortal_Configuration_wizard.jpg?alt=media)

<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.

### Licensing (BYOL)

The AWS Marketplace listing is Bring Your Own License: AWS does not charge for the ProSBC software, and the instance needs a ProSBC license from TelcoBridges to process calls.

1. Order a ProSBC license, or renew an existing one, from the [TelcoBridges Customer Dashboard](https://dashboard.telcobridges.com). See the [Customer Dashboard User Guide](/troubleshooting-and-support/support-links/customer-dashboard-user-guide.md).
2. Download the license for your instance's serial number: [Retrieving a License](/maintenance-and-troubleshooting/system-upgrade/retrieving-a-license.md).
3. Upload the license from the ProSBC web portal: [Uploading a License](/initial-installation/3.-uploading-a-license.md).

{% hint style="info" %}
If you need a license or have questions about pricing, contact TelcoBridges sales or support. AWS Marketplace does not deliver the ProSBC license.
{% endhint %}

### 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

* [ProSBC on AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-5ffv5kyvr3q66)
* [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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.