NAME

powerdyndns-client - dyn.org and PowerDynDNS compatible dynamic DNS client

SYNOPSIS

DESCRIPTION

powerdyndns-client is a dyn.org and PowerDynDNS compatible dynamic DNS client program. It is normally a long-running program that monitors your IP address and updates it when the IP changes, but with --once it checks your IP once, updates if necessary, and exits.

powerdyndns ships with powertinydyndns, so both services may be available. When run together, they share users/passwords/hostnames.

powerdyndns-client should be run continuously via either cron or systemd.

OPTIONS

-V, --version

Shows powerdyndns-client version on standard output and exits.

-h, --help

Shows brief help and exits.

-c /path/to/config.php, --config /path/to/config.php

Specifies the path to the config file that will be used, overriding the defaults.

-o, --once

Checks your IP once, updates if necessary, and exits.

-f, --force

Forces (first) update, even if IP address has not changed.

-i, --ip

Shows current external IP address.

CONFIGURATION

If --config is not specified on the commandline, cascading config files are used. First, /etc/powerdyndns-client.conf.php is loaded, and then ~/.config/powerdyndns-client.conf.php. This means settings in the user's config file override settings in the system-wide config file.

Configuration Options:
<?php
$dynhost = 'hostname'; // sets hostname[.dyn.example.com]
$dyndomain = 'dyn.example.com'; // domain name of the dynamic DNS service
$dynuser = 'user';
$dynpass = 'password';
$cycle = 300; // seconds between IP checks (300 = 5 minutes)
$alerts = TRUE;
$mailto = 'you@example.com';
$mailfrom = 'you@example.com';
$direct = FALSE; // gets IP address directly on Linux (maybe)
$checkip = 'https://checkip.example.com'; // indirect IP address URL
$lockwait = 180; // seconds to wait for lock before giving up (180 = 3 minutes)
$lockfile = '/tmp/powerdyndns-client_USERID.lock';
$saveip = '~/.external-IP'; // default
$syslog = FALSE; // log to syslog
$logfile = '~/logs/powerdyndns-client.log';

powerdyndns-client supports the ~ shortcut to the user's homedir.

AUTHORS