Configuring FreePBX 14 for the first time can be a confusing process due to the relative complexity of FreePBX's interface. However, SIP.US provides a custom module that will configure your SIP Trunks and DIDs to your server, automatically.
Step 1 - Download the SIP.US Configuration Module
First, it is necessary to download sipus-3.13.3.tar.gz, which is an archive of the latest version of the Module.
Note: Do not extract the
.tar.gz archive – FreePBX will expand it automatically.
Step 2 – Upload the Module to FreePBX 14
After logging in as an administrator on your FreePBX server, go to the Admin -> Module Admin tab.
Next, click the "Upload Modules" button at the top of this page. Select "Upload (From Hard Disk)" as the type of this upload, then click the "Choose File" button to find and select the .tar.gz file downloaded in Step 1. Finally, click the blue "Upload (From Hard Disk)" button to upload the Module to FreePBX.
Step 3 – Install the Module
Now that the Module is uploaded, click the blue "local module administration" link.
Now it is necessary to install the module. Do this by scrolling down to the "Connectivity" module section and expanding the SIP.US Configuration line-item. Next, select the "Install" option to instruct FreePBX to install the Module. After clicking "Install," confirm the installation by clicking the blue "Confirm" button on the next screen.
Finally, scroll back to the top of the page, and select the blue "Process" button on the top-right of the screen to initiate the install process.
Step 4 – Find Your FreePBX Configuration Key
Before you can use the SIP.US Configuration Module, you must first find you FreePBX "Secret Key" which can be found by going to the SIP Trunking -> FreePBX Config tab in the Customer Portal:
Then, you will look for the line that says: "To view your secret key, click HERE." Clicking that length will display a 32-character secret key that will be used in the next step. Copy this value to your clipboard at this time.
Step 5 – Provide Your Configuration Key to the Module
Now that the Configuration Module has been installed, it is time to provide the secret key that you retrieved from the Customer Portal to the Module. To access the Module, click on the Connectivity -> SIP.US tab in FreePBX.
Finally, paste your FreePBX Configuration secret key (found in Step 4) into the text box, and click the purple "BEGIN" button to begin the configuration process.
Step 6 – Select DIDs and Trunks to be Configured
Next, select the trunks or trunks (usually only one DEMO trunk for new users) and any DIDs you wish to configure. Please note, configuring DIDs at this stage is not required. Once you have selected the trunk(s) you wish to configure and routed your DIDs, press the purple "SUBMIT" button to finish installation.
Step 7 – Click Apply Config
Finally, the SIP configuration changes have been made to FreePBX. In order for these changes to take effect, click the red Apply Changes button in the top-right of your screen. This will restart the Asterisk server and the trunks will attempt registration.
At this point, the trunks that you selected in the Module should be registered to the SIP.US Gateways, the DIDs you chose are routed, and a default Outbound Routes template has been created for the SIP.US trunks.