Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Wide-area Multicast DNS Updater
Branch: master
Pull request Compare This branch is 14 commits ahead of Roguelazer:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



Wamupd was originally created by roguelazer - for the original application, see This version is primarily forked to support the stable versions of Ruby (1.9), mDNSResponder (258.18), Avahi (0.6.29), D-Bus (1.4.6), and FreeBSD (8.2) at the time of writing. It also fixes some threading issues, adds logging, rc.d support, and FreeBSD packaging.


  • ruby19
  • ruby-dbus (see my fork on GitHub)
  • algorithms
  • rubygems
  • dnsruby
  • logger

ruby-dbus v0.6.0 does not work properly on FreeBSD due to a problem with the initial null byte sent to D-Bus for unix socket authentication. FreeBSD supports the SCM_CREDS socket option, so a simple patch is required.


After cloning this repository, use gmake to create the wamupd package and then install the resulting file:

git clone
cd wamupd
sudo pkg_add wamupd.tbz

Once installed, create the configuration file using the distribution template and enable the wamupd service in your /etc/rc.conf:

cd /usr/local/etc/
sudo cp wamupd.yaml.dist wamupd.yaml
sudo vim wamupd.yaml (edit appropriately)
sudo echo wamupd_enable="YES" >>/etc/rc.conf
sudo service wamupd start

Specify custom arguments to wamupd as needed using the wamupd_flags entry in /etc/rc.conf. In order to get more information on the arguments available, try this:

sudo service wamupd stop
sudo /usr/local/sbin/wamupd run -- -h

The default flags used are:

wamupd_flags="-c /usr/local/etc/wamupd.yaml -A /usr/local/etc/avahi/services -a -i"

A log is created at /var/log/wamupd.log, but this only contains small amounts of information. In order to debug your configuration, make sure the service isn't running and then execute the /usr/local/sbin/wamupd program in the foreground (note: the typical arguments used are "-A -a -i" - the "--" separates the daemon command from the script arguments):

sudo service wamupd stop
sudo /usr/local/sbin/wamupd run -- -A -a -i

To uninstall, simply use pkg_delete:

sudo pkg_delete wamupd


Usage: wamupd run -- [options] service-file
    -c, --config FILE                Get configuration data from FILE
                                     If FILE is not provided, defaults to /usr/local/etc/wamupd.yaml
    -A, --avahi-services [DIRECTORY] Load Avahi service definitions from DIRECTORY
                                       If DIRECTORY is not provided, defaults to /usr/local/etc/avahi/services
                                       If the -A flag is omitted altogether, static records will not be added.
    -i, --[no-]ip-addresses          Enable/Disable Publishing A and AAAA records
    -a, --avahi                      Load Avahi services over D-BUS
    -h, --help                       Show this message


Make a wamupd.yaml file in /usr/local/etc/ in normal YAML style. Available parameters include:

  • hostname: the hostname of this machine
  • zone: the zone to write to
  • dns_server: the dns server that controls the above zone
  • dns_port: the port to talk to
  • dnssec_key_name: the key name for DNSSEC. Do not specify if you're not using DNSSEC
  • dnssec_key_hmac: the key value for DNSSEC.
  • ttl: the standard TTL to use.
  • transport: either "tcp" or "udp"
Something went wrong with that request. Please try again.