DDClient For Mac OS X

DDClient is a Perl based IP update client for *nix as well as OS X. It supports operating as a daemon as well as optimizes updates for multiple hostnames and aliases.

Get Xcode

Download and install Xcode as you will need it to install Homebrew which installs stuff which Apple doesn't.

After installation, please open Xcode and agree to the license to continue installation of its components.

Get Command Line Tools

Press the 'Command' key and 'Space' bar together to open spotlight, type in 'terminal' and hit 'Enter' to open the terminal.

Using the terminal, install the command line tools.


            xcode-select --install

Install Homebrew

Homebrew is a package manager designed to install *nix tools and other open-source applications on Mac OS X.

Download and install Homebrew using its script as shown below.


            ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Run the following command once you’re done to ensure Homebrew is installed and working properly.


            brew doctor

Install ddclient

Use brew to install ddclient using the command as shown below.


            brew install ddclient

Configure ddclient

Create the ddclient configuration file for your username, password and domain name. Please refer to the ddclient area for more configuration options.


            vim /usr/local/etc/ddclient/ddclient.conf

# ddclient configuration for Dynu
#
# /etc/ddclient.conf
#daemon=60                                                   # Comment this line for OS X
syslog=yes                                                   # Log update msgs to syslog.
mail=root                                                    # Mail all msgs to root.
mail-failure=root                                            # Mail failed update msgs to root.
use=web, web=checkip.dynu.com/, web-skip='IP Address'        # Get ip from server.
server=api.dynu.com                                          # IP update server.
protocol=dyndns2                        
login=myusername                                             # Your username.
password=YOURPASSWORD                                        # Password or MD5 of password.
YOURDOMAIN.DYNU.COM                                            # List one or more hostnames one on each line.
#YOURDOMAIN.COM

Run ddclient

You can test ddclient using the command as shown below though we recommend that you set it up as a job which starts at system boot.


         sudo ./usr/local/opt/ddclient/sbin/ddclient -verbose -noquiet

Start At Boot

Setup ddclient to start automatically when the system boots up.


            sudo cp -fv /usr/local/opt/ddclient/*.plist /Library/LaunchDaemons


            sudo chown root /Library/LaunchDaemons/homebrew.mxcl.ddclient.plist


            sudo launchctl load /Library/LaunchDaemons/homebrew.mxcl.ddclient.plist

You can check the system log to troubleshoot any issues.


            tail -f /var/log/system.log

Force Update

You can force an IP update as shown below.


          sudo ./usr/local/opt/ddclient/sbin/ddclient -force -verbose -noquiet

Heads up!

Well done!

Oh snap!

Warning!