> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firetone.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# SIP trunks

> Connect your own PBX: what your provider allows you, creating a trunk within it, what to type into the PBX, and reading a trunk's page when calls fail.

A **SIP trunk** connects your own phone system (your PBX) to FireTone:

* your PBX's outgoing calls go out through your provider's carriers, billed
  to your organisation at your rates;
* your numbers can ring your PBX.

**SIP trunks** is in the menu when your provider offers it.

## Your allowance

Your provider sets how much you may create for yourself. The card at the top
of **SIP trunks** shows it as bars:

| Bar | What it counts |
| - | - |
| **Trunks** | Trunks you have, of those you may have |
| **Concurrent calls, all trunks** | Your trunks' concurrent-call limits added up, of the total you may give them |
| **New calls per second, all trunks** | The same for calls per second |
| **Sign-in by fixed IP** | Whether a trunk may sign in by address instead of a password |

A bar full is a limit reached, not a fault. Ask your provider to raise it.

If the card says your organisation cannot create trunks, trunks your provider
set up for you are still listed, and you can still read their pages and
reset their passwords.

## Creating a trunk

**SIP trunks → New client trunk.** Give it:

* a **name**;
* a **concurrent-call limit** and a **calls-per-second limit** (both
  required, and inside what your allowance has left);
* the **codecs** your PBX speaks;
* if you like, the **countries** it may call and a **tech prefix** your PBX
  adds to every number.

The trunk signs in with a password unless your allowance allows fixed-IP
sign-in and you choose it.

When you save, **PBX settings** opens with what to type into your PBX: the
server, the username and SIP domain, and the password.

<Warning>
  The password is shown **only now**. Copy it into your PBX before you close
  the window. If you lose it, **Reset password** issues a new one, and your
  PBX stops working until you enter it.
</Warning>

## Caller ID

Your trunks present **only your organisation's own numbers**. If your PBX
sends another number, it is replaced by the trunk's default caller ID. Other
caller-ID policies are for your provider to set.

## Numbers that ring your PBX

To send one of your numbers to your PBX: **Numbers → edit → Destination →
Client trunk**. A password trunk must be registered for the call to reach it.

## When calls fail: the trunk's page

Click a trunk's name.

* **Now** shows whether your PBX is registered, the calls up now, and any
  sign-ins refused today.
* **Limits** shows your calls against the trunk's limits.
* The tabs hold the history:
  * **Sessions**: registrations now and in the last 7 days;
  * **Sign-ins**: refused attempts, with the reason;
  * **Calls**;
  * **Changes**: who changed the trunk.

| You see | Do this |
| - | - |
| Not registered, sign-ins refused as *wrong password* | Enter the current password in the PBX, or reset it |
| Not registered, no refused sign-ins | Check the server, the SIP domain and port 5060 in the PBX |
| Calls now at the limit | Wait for a call to end, or raise the limit within your allowance |
| Calls to some countries fail | The trunk's countries leave them out |
| Emergency calls fail | They always do on a SIP trunk: it carries no location. Send them over a local line |

## What you cannot change

* **Your allowance.** Your provider sets it.
* **Caller ID beyond your own numbers.**
* **Settings your provider made** on a trunk. They are kept when you edit it.