Scroll to navigation

ipcheck(8) client to register your dynamic IP address ipcheck(8)


ipcheck - client to register your dynamic IP address


ipcheck [options] Username Password Hostnames
ipcheck [options] --acctfile acct_info_file


ipcheck is a simple Python script to register your dynamic IP address using the NIC V2.0 protocol. It aim to be fully compliant with the dyndns client specification.

The script is very easy to use and supports multiple methods for determining the external IP (parsing interfaces on the local machine, web based IP detection, direct support for devices from Linksys, Netgear, Draytek, Netopia, HawkingTech, Watchgard, Cayman, Nexland, ZyXEL, SMC, Compex, UgatePlus, DLink and Cisco).

Run the script with no command line arguments for quick start instructions.


-a address
Manually specify the address.
-r URL
NAT router, use web IP detection.
-A text
Scan syslog for an IP after text (Unix only).
-F filename
Guess the WAN IP from a firewall log.
Backup mx option ON (default OFF).
Custom dns option (default dynamic).
-d dir
Directory for data files (default current).
-e script
Execute script after a successful update.
Force update regardless of current state.
NAT router, let dyndns guess your IP. (do not use this in a cronjob, try -r).
Print this help text.
Print all available help text.
-i interface
Interface for local address (default ppp0).
Disable https.
Log debugging text to ipcheck.log file.
Log debugging text to syslog (Unix only).
-m mxhost
MX host (default NOCHG).
Set dyndns offline mode.
Proxy bypass on port 8245.
Quiet mode (unless there is an error).
Static dns option (default dynamic).
Test run, do not send the update.
Verbose mode.
Wildcard mode ON (default OFF).
Create the ipcheck.dat file by dns lookup.
Print router options (Linksys, Netgear, etc).
-n ip
The router IP address on the internal lan.


  • For help with different options: ipcheck -h
  • For supported devices listing: ipcheck --devices
  • For long detailed help text: ipcheck --help


Example 1: the external IP is on eth0 of the current machine:

    # ipcheck -l -i eth0 username password hostnames
Example 2: you are using the Linksys routing device:

    # ipcheck -l -L linksyspassword username password hostnames
Example 3: you want to use web based ip detection:

    # ipcheck -l -r ...
where ... is your dyndns username password and hostnames. Hostnames should be comma delimited if there are more than one.


ipcheck was written by Kal <>.

This manual page was written by Joao Eriberto Mota Filho <> for Debian project (but may be used by others).

15 Oct 2016 ipcheck-0.233