Digium Gateway First Steps
- Nathaniel Halbrooks
- 1 Introduction
- 2 Opening the box
- 3 Connectivity
- 4 Logging in
- 4.1 Secure your login
- 4.1.1 Full Name
- 4.1.2 Email Address
- 4.1.3 Password
- 4.1.4 Password Confirmation
- 4.1.5 Language
- 4.1.6 Save
- 4.1 Secure your login
- 5 Setting an IP
- 5.1 General Network Options
- 5.1.1 Hostname
- 5.1.2 Also Continue Using Default Install IP Address
- 5.1.3 DNS Addresses
- 5.2 Interface Tab
- 5.2.1 Static IP assignment
- 5.1 General Network Options
- 6 Connecting to FreePBX
- 6.1 On the gateway
- 6.1.1 Enable Advanced Options
- 6.1.2 Name
- 6.1.3 Username
- 6.1.4 Password
- 6.1.5 Registration
- 6.1.6 Use UDP
- 6.1.7 Use TCP
- 6.1.8 Use TLS
- 6.1.9 Nat Traversal
- 6.2 On FreePBX
- 6.2.1 General Settings
- 6.2.2 Outgoing Settings
- 6.2.2.1 Trunk Name
- 6.2.2.2 Peer Details
- 6.2.3 Incoming Settings
- 6.2.4 Registration
- 6.2.4.1 Register String
- 6.3 Save
- 6.4 What's Next?
- 6.1 On the gateway
Introduction
This guide will get you started with FreePBX and Digium gateways.
Opening the box
When you open the box please review the "Quick Start Guide" included in the box. Physically install the box per Digiums instructions.
Connectivity
LAN
The Ethernet (ETH) port will attempt to acquire a DHCP address on your network when booted. You can look at the device table on your DHCP server for the gateway to obtain it's address.
Above is what appeared in my list. The host name format is: <Model>-ff-ff-ff.
If you would like to set this up without a DHCP server you may use the gateway's built in IP address 192.168.69.1 by direct Ethernet connection or by adding a vlan to the 192.168.69.0/24 network on your network.
T1/E1
This is not used in the scope of this guide but you will connect your T1 or E1 to this port.
Logging in
In your favorite browser go to the IP of the gateway using https. My gateway was assigned 192.168.9.33 by my DHCP server so I will go to https://192.168.0.33
You will land on the login page:
The default User Name is admin
The default password is admin
Enter your credentials and click Log In
Secure your login
On the right if you are using the defaults you will see a message:
Click the link changing your password
This will take you to the administrators page.
Click on the pencil under Actions.
The form to edit the user will pop up.
Full Name
Description of the user. You may leave this as is, or change it
Email Address
Set this to a proper email address
Password
Set this to your new password
Password Confirmation
Enter the same thing you put in to password
Language
Set this to your appropriate language.
Save
Once you click save you will be logged out
Enter in admin for the username and the password you just created.
Setting an IP
From the main page (https://yourip) click on the configuration banner
In the popup box click IP Configuration
This will bring you to the network settings
General Network Options
This can either be left default or updated to your preferences.
Hostname
How this device should identify to the network
Also Continue Using Default Install IP Address
You can disable the default IP or leave it in place
DNS Addresses
The IP address(es) of your DNS servers for FQDN resolution.
Interface Tab
Here you may set a static IP for your system if you do not wish to use DHCP
Static IP assignment
Change Obtain an IP Address via DHCP to NO
In System IP Address enter an IP address that is unique on the network
In Network Mask enter the appropriate netmask. Example 255.255.255.0
In Gateway Address enter the default gateway. Typically your router.
Click Save IP Configuration
In the popup click Continue
APPLICATION NOTE
Note if you were connected to the DHCP address you will need to enter the new IP in your browser window.
Connecting to FreePBX
On the gateway
From the main page (https://yourip) click the configuration banner
In the pop up window click SIP Endpoints
In the SIP Endpoints landing click the Create SIP Endpoint button
This will pop up the Main Endpoint Settings window.
Enable Advanced Options
These are not covered within the scope of this guide. Leave this to no
Name
Give the endpoint a descriptive name. In our case we call it FreePBX
Username
The username FreePBX will use to connect to the gateway. This can be anything as long as it corresponds with whats in FreePBX. For our example we will use freepbx.
Password
The password FreePBX will use to connect to the gateway. Common sense password rules should be used here. In our example we use freepbx but this is not generally a god idea
Passwords should use a mix of upper and lower case letters
Passwords should include a number
Passwords should NOT be the same as the username
Passwords should not be based on a dictionary word.
Our example and these rules are informational only. You are responsible for your own security.
Registration
Choose Endpoint registers with this gateway
Use UDP
Set to Yes
Use TCP
Set to No
Use TLS
Set to No
Nat Traversal
This setting is network dependent.
On FreePBX
Log in to the FreePBX UI
On the top menu click Connectivity
In the drop down click Trunks
On the landing page click Add SIP Trunk
General Settings
Trunk Name
Give your trunk a descriptive name. We will use Digium Gateway
Outgoing Settings
Trunk Name
Name your trunk, we will use DigiumGateway
Peer Details
Peer Details
host=192.168.0.33
defaultuser=freepbx
secret=freepbx
type=friend
context=from-trunk |
Set the host to your gateways IP
Set defaultuser to the Username you created in the gateway
Set secret to the password you created in the gateway
Set the type to friend
Set context to from-trunk
If you want to monitor the status via "sip show peers" you should also add qualify=yes
Incoming Settings
Delete contents. Leave blank.
Registration
Register String
username:password@gatewayIP
Save
Click Submit Changes then press the Apply Config button at the top