Last edited · 58 revisions   


Setup ircDDBgateway

This example is on Compass Linux for the UDRC as dstarrepeater 1

You can pull and edit a seed file or use the GUI tool to edit the configuration file.

ircDDBGateway Configuration non-GUI

Install non-gui ircddbgatewayd

Not recommended, unless you are familiar with the ircddbgateway configuration file and manual editing.

sudo apt-get update
sudo apt-get install ircddbgatewayd

Get the seed file for ircddbgateway

sudo curl -L -s -o /etc/opendv/ircddbgateway

Edit and save /etc/opendv/ircddbgateway

ircDDBGateway Configuration using ircddbgatewayconfig

Install ircddbgateway (GUI) and ircddbgatewayd (daemon)

Recommended for new users.

sudo apt-get update
sudo apt-get install ircddbgateway ircddbgatewayd

This install will also install ircddbgatewayconfig

Start the ircddbgatewayconfig tool in a terminal

	sudo ircddbgatewayconfig

It may take a long time to startup, perhaps 2 minutes.

The ircddbgatewayconfig tool has a series of tabs

Gateway Tab

Set the Callsign to the callsign you have registered at or to your callsign if you do not have a registration.

Setting the Local HB Address to will cause ircddbgateway to listen on all IPv4 addresses on the computer.  This is useful if you have other repeaters at different IP addresses.  If all repeaters are attached to the same computer, then use Leave the Local HB Port at the default 20010. The Icom settings should be left as set, in case you have an Icom ID-RP2C attached, now or in the future.

Repeater 1 - 1st Tab

Leave the Address at for a dstarrepeater (UDRC) that is on the same computer.  The Port is the UDP port the dstarrepeater is configured to listen on, the default for the first repeater is 20011. Leave the port at the default unless you have more than one device attached.  The IP address and port may need  to be changed if you have additional repeaters attached to the gateway.

You may also set a default Reflector and whether to connect at Startup and whether to Reconnect after a period of inactivity or to stay continuously linked to a fixed reflector.

Repeater 1 - 2nd Tab

This tab is self explanatory.

Additional Repeaters

Follow the same steps for additional repeaters.  Note how a different IP address can be used if the dstarrepeater (UDRC or Other) is on the LAN or even over the Internet.

If this repeater was on the same computer, the Address would be and at a different UDP port, like 20012.

A Repeater on an Icom ID-RP2C

Note: If you have migrated from a G2 system, the 10.x.x.x network is not needed on ircddbgateway.  You can set the LAN address on your router to 172.16.0.x (like and set your Pi's network configuration to point to that address as its Internet gateway.

If your LAN uses a different net, eg. 192.168.0.x/24, you can set the ID-RP2 to use an address on that network and adjust settings accordingly or put a second IP address on the eth0 of the Raspberry Pi -- see

ID-RP2C+ircDDBgateway+router on a single LAN

If you only want to use a single network port and LAN it is a simple networking problem, just keep your addresses and ports straight.

Using the illustration (replace IP addresses as appropriate on your network)
Tell the router to forward needed ports to the gateway's IP address at 
In ircddbgatewayconfig:
On the RP2C:
  • Set Gateway to address and port to 20000
  • Set Communications Settings to IP Address and port to 20000 with appropriate netwmask (usually
That's it.  A simple network configuration.

ircddb Network

For registered gateways, enable ircDDB, select the server Hostname (Group2-irc in the Americas, Group1-irc for the rest of the world). Along with the Username and Password from your registration.

If your gateway is not registered on, then disable this tab.

OpenQuad Network

For unregistered gateways or as a second network, enable ircDDB, select the server Hostname ( and your callsign as the Username. Leave the Password empty.  We use the ircDDB 2nd Network tab for this entry.  Most gateways will enable this feature for maximum connectivity.

You can be connected to both networks.

Enable DPRS Reporting

Enable and put in an APRS-IS Hostname and Port.

Enable DExtra 

This is for XRF reflectors and gateway to gateway linking as well as AMBE device (ThumbDV/PiDV/...) connections.

Enable DPlus

This will connect to REF reflectors as a hotspot style connection, as well as gateway and AMBE device connections.  The Login is a US Trust registered callsign, use your personal callsign if you don't have a club callsign registered as a user. DO NOT USE 'CALLSIGN' AS IN THE EXAMPLE, USE A US TRUST REGISTERED CALLSIGN.

Enable DCS/CCS

This allows connection to DCS reflectors and initiating CCS links.  Select a CCS Server

Enable Remote Control

Select a Password and UDP Port. This allows remote control of the gateway through programs including applications for the iPhone and Android.

Miscellaneous Functions

Select your preferred Language and various functions.

Save and Exit

Save your configuration, which is stored in a file at /etc/opendv/ircddbgateway in Compass Linux.  Exit the program.

Setup Port Forwarding

Jim Moen, K6JM has put together a good list of ports needing forwarded from your router to the Gateway.

Based on Jim's list, it is possible to use a script on Linux to automatically update port forwarding based on UPNP.

Get the tool to update UPNP entries

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install miniupnpc

Download the script


cd ~
curl -L -s -o
chmod +x

This script was tested against a MikroTik router, but should work with other UPNP capable routers.  You may have to enable the UPNP feature on the router.


Note: You may edit the script to open your Remote Control port, if you have configured one.

Using the script is very easy.  It takes two arguments.  The first is the interface used for the Internet, typically eth0 or wlan0. The second is either start to load the rules or stop to unload them.

cd ~
~/ eth0 start
~/ eth0 stop

You may have to rerun the script if your router changes its public IP or is rebooted, depending on your router's capabilities.  This script should be run on reboot of the gateway computer, or if the gateway computer gets a new IP based on DHCP leases.

Startup ircDDBGateway as a daemon

Startup the daemon and observe the log.

sudo systemctl start ircddbgatewayd
sudo tail -f /var/log/opendv/ircddbgatewayd.log

Once you are satisfied all is working, setup ircddbgatewayd to automatically start on boot up.

sudo systemctl enable ircddbgatewayd

Reboot and verify that ircddbgatewayd is running

sudo reboot
sudo systemctl status ircddbgatewayd


If you would like a web based real time dashboard for ircDDBGateway, check out the real time dashboard at  ircNodeDashboard

Reflector Host Files

The reflector host files can be found in /usr/share/opendv

cd /usr/share/opendv ; ls -l *.txt

Here is a little procedure to change all IP based REFxxx references to use their DNS name instead. Available as

cd /tmp
curl -o DCS_Hosts.txt
curl -o DExtra_Hosts.txt
curl -o DPlus_Hosts.txt
for hosts in DCS_Hosts.txt DExtra_Hosts.txt DPlus_Hosts.txt
	if grep -Fq "# Prepared at" "$hosts" 
		echo "Copying $hosts"
		sudo cp "$hosts" /usr/share/opendv
		echo "$hosts Bad, not copied"
	rm "$hosts"
echo "Restart ircddbgateway to use new files ..."


This Wiki page is offered as a courtesy of NW Digital Radio, technical support for ircddbgateway is on Yahoo!