> 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/telecom-references/voice-and-media/freesbc-networking.md).

# FreeSBC:Networking

### Requirements

TSBC-SW deployments require a minimum of two networks for initial configuration. The first network will be used as a local management interface to access the instance using the web portal (HTTP/HTTPS) and SSH access. The second network will transport the actual incoming and outgoing VoIP streams (signaling and media) that the TSBC-SW will process.

![Tsbc sw minimal networks](https://docs.telcobridges.com/w/images/4/4d/Tsbc-sw-minimal_networks.png%E2%80%8E)

The TSBC-SW can handle up to 32 different physical interfaces which allows numerous different deployment configuration to fit any networking needs.

![Tsbc sw any networks](https://docs.telcobridges.com/w/images/5/51/Tsbc-sw-any-networks.png%E2%80%8E%E2%80%8E)

### Network setups

Depending on the technical requirements of a particular deployment, a TSBC-SW can be installed as a standalone or protected (1+1) system. These options have different network needs to fulfill their functions. In addition to redundancy, the support of external transcoding equipment with the TSBC-SW also adds to the network requirements. The following section depict the different supported network configurations.

#### Redundancy

**Standalone without transcoding**

In this configuration, the TSBC-SW does not have any backup instances nor is using any transcoding equipment. Thus, the only networks needed are the management network along with one or many VoIP networks to carry the data streams. In the example below, the TSBC-SW was deployed with one "public" network named 'wan0' and one "private" network named 'lan0'.

![Tsbc sw standalone notrans](https://docs.telcobridges.com/w/images/e/ed/Tsbc-sw-standalone-notrans.png%E2%80%8E)

**1+1 without transcoding**

In this configuration, the TSBC-SW system is deployed with two instances providing an active/standby redundancy scheme without any transcoding equipment. In addition to the regular networks required shown in the previous example (management and VoIP networks), the two instances need access to two control separate networks allowing to exchange check-pointing information. These networks are private to the TSBC-SW and should never be shared or be visible to non-TelcoBridges equipment.

Although a single control network is sufficient to achieve the 1+1 function, it is not recommended by TelcoBridges unless the operator fully controls all network segments and can guarantee it can never fail at both the physical and routing (IP) layer. In most cases, having two separate control networks going through independent network devices, switches and routers is the only way to ensure 'no single point of failure'.

![Tsbc sw 1p1 notrans](https://docs.telcobridges.com/w/images/3/3e/Tsbc-sw-1p1-notrans.png%E2%80%8E)

#### Transcoding

The TSBC-SW session border controller should be the only equipment facing the different networks to ensure proper protection and monitoring. In that sense, any transcoding units deployed (TSBC-HW-TRANS) will never be visible from data networks handled by the SBC. The TSBC-SW will require three internal networks to reach the transcoding units: two control networks and one media network. The control networks are the same as those deployed for redundant systems while the media network will contain all the VoIP traffic coming in or out of the transcoding units.

![Transcoding](https://docs.telcobridges.com/w/images/1/1e/Transcoding.png)

**Standalone with transcoding**

Combining the standalone network requirements to the transcoding network needs, the deployment of such a system requires multiple networks as depicted below:

![Tsbc sw standalone withtrans](https://docs.telcobridges.com/w/images/2/2c/Tsbc-sw-standalone-withtrans.png%E2%80%8E%E2%80%8E)

**1+1 with transcoding**

Combining the redundant network requirements to the transcoding network needs, the deployment of such a system requires multiple networks as depicted below:

![Tsbc sw 1p1 withtrans](https://docs.telcobridges.com/w/images/7/7f/Tsbc-sw-1p1-withtrans.png%E2%80%8E%E2%80%8E)

### Network device discovery

Once all networks have been physically (or virtually) connected to the TSBC-SW instance, the system can be started. Upon first bootup (or after an operator initiated 'network device role' reset), the TSBC-SW web portal will show a network device assignation page. As the TSBC-SW cannot guess what type of traffic the operator wants to process on any given network, this page is used to identify the role of each detected devices. As described above, the role can be any of the following three: control, management or VoIP traffic (named LAN/WAN). Once the role is selected, the operator can enter a name for each. Every configured/detected physical network device will then appear as a 'physical port' in the 'IP Interace' tab in the web portal.

The operator can click on the '+' sign to get more information about a specific network device. These information are helpful to match detected networks with the real network based on these characteristics (IP, driver type, etc).

![network discovery](https://docs.telcobridges.com/w/images/e/ee/Network_discovery.png%E2%80%8E%E2%80%8E)


---

# 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/telecom-references/voice-and-media/freesbc-networking.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.
