DDClient For Mac OS X 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 XCode Download and install Xcode as you will need it to install Homebrew which installs stuff which Apple doesn't.

Install Xcode

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

Install Xcode

Get Command Line Tools

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

Mac keyboard

Open Terminal Using the terminal, install the command line tools.

xcode-select --install

Install Command Line

Install Command Line

Install Command Line

Install Command Line

Install Homebrew

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

Install Homebrew Download and install Homebrew using its script as shown below.

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

Install Homebrew

Install Homebrew

Install Homebrew

Install Homebrew

Install Homebrew

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

brew doctor

Brew Doctor

Install ddclient

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

brew install ddclient

Install DDClient

Configure 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

Configure DDClient

Configure DDClient

# 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.
login=myusername                                             # Your username.
password=YOURPASSWORD                                        # Password or MD5/SHA256 of password.
YOURDOMAIN.DYNU.COM                                            # List one or more hostnames one on each line.

Run ddclient

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

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

Start DDClient at boot

Start DDClient at boot

Check log file You can check the system log to troubleshoot any issues.

tail -f /var/log/system.log

Force Update

Force DDClient update You can force an IP update as shown below.

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

Force Update DDClient