FIRST STEP Sign up on www.no-ip.com Your email address will be the username, and you will receive a password to that email address. Then you can login at www.no-ip.com and add the hostnames you want. If you want to have many hostnames on one ip-address you could create a group with these hostnames and use the GROUP entry in the no-ip.cfg file. Both HOSTNAME,DOMAIN and GROUP has to be present in the no-ip.cfg file, but the first two can contain only ; if the group is used and the GROUP entry can contain only ; if the HOSTNAME and DOMAIN is used. All entries must be present in the no-ip.cfg file as described later. ########################################################################### INSTALLATION ON FLOPPYFW copy the following files to a:\packages no-ip.bz2 no-ip.cfg post-nip.ini the no-ip.bz2 contains /bin/noip which is the binary the no-ip.cfg file is the configuration file and should be modified as describe later in this document. the post-nip.ini is autorun by floppyfw and will copy the no-ip.cfg file from the floppy and into /etc/no-ip.conf ########################################################################### SAVED STATE (Possibly not in floppyfw distribution) Noip will save the last IP address that was set at no-ip.com to a file, /tmp/no-ip_save, when it ends. This file will be read back in the next time noip is started in DAEMON mode. ########################################################################### COMMAND LINE ARGUMENTS WHEN INVOKING THE CLIENT The client can be invoked with the [-i IPaddress] parameter which will The client can be invoked with the [-i IPaddress] parameter which will force the setting of that address at no-ip.com. If the client is configured for daemon mode, the client will override that setting and run once and exit. The actions of the client are controlled by a configuration file. It is usually located in /usr/local/lib/no-ip.conf, but may be placed anywhere if the [-c new_location] argument is passed on the startup line. (/etc/no-ip.conf is default for floppyfw) All errors and informational messages are stored via the syslog facility. They are written to stderr if the [-l] flag is given. A line indicating a successful address change at no-ip.com is always written to the syslog. One final invocation parameter is -h. This displays the help screen as shown below and ends. USAGE: noip [-c config_file] [-h] [-l] [-i IPaddress] [-d] Version Linux-1.6 Options: -c config_file use alternate config file -h help -i IPaddress use supplied address -l log output to stderr -d increase debug verbosity config file is either /usr/local/lib/no-ip.conf or /usr/local/etc/no-ip.conf and must contain 10 required entries in the form of KEYWORD = value A complete description of the config file is in the README file. KEYWORD value (example) LOGIN = YourNo-ip.comLogin (foo@host.org) PASSWORD = YourNo-ip.comPassword (hello25-1) HOSTNAME = YourNo-ip.comHost (grumpy) DOMAIN = YourNo-ip.comDomain (no-ip.com) GROUP = YourNo-ip.comGroup (mygoup) DEVICE = YourInternetConnectionDevice (ppp0) PROXY = Y/N (Y) NAT = Y/N (N) DAEMON = Y/N (Y) INTERVAL = Minutes (30) ########################################################################### CONFIGURATION FILE DESCRIPTION The client has two modes. The first is run once and end. The other is act as a daemon and run perpetually. The mode is selected by the 'DAEMON = ' keyword/value line in the configuration file. 'DAEMON = Y' means run perpetually, 'DAEMON = N' means run one time and exit. If the first character of the value is not 'Y' or 'y', 'N' is assumed. The client should use a proxy port instead of the usual port 80 to talk to no-ip.com. The selection is made in the configuration file by setting 'PROXY = Y' or 'PROXY = N'. If the first character of the value is not 'Y' or 'y', 'N' is assumed. The PROXY value defaults to Y if the configuration script is run. Most users should use this value. The interval between successive testing for a changed IP address is controlled by the 'INTERVAL = nn' line. The number is minutes, a minimum of 1 is enforced by the client, a usual value for clients behind firewalls would be 30. The NAT line controls whether the IP address to set at no-ip.com is obtained locally or from a getpeer operation at no-ip.com. This parameter is used by those systems behind NAT firewalls. The format is 'NAT = Y' or 'NAT = N'. If the first character of the value is not 'Y' or 'y', 'N' is assumed. The device used to make your external connection is listed on the 'DEVICE = devx' line. The value for this line can be obtained by looking at the output of the /sbin/ifconfig program while connected to the Net, or by running the ./no-ip.sh program which will list the valid devices. This value is ignored if you are using Network Address Translation mode (NAT), but it must be present. Using 'DEVICE = unused' is suggested. The remaining five lines consist of LOGIN, PASSWORD, HOSTNAME, DOMAIN and GROUP. LOGIN = your login at no-ip.com (usually your email address) PASSWORD = your password for the above login HOSTNAME = your hostname at no-ip.com DOMAIN = your domain at no-ip.com or myftp.org or ... GROUP = your groupname at no-ip.com The GROUP line should contain a single semicolon as the value if a group is not to be used. If the GROUP value contains anything else, it will be assumed that a valid grouping exists at no-ip.com and GROUP will take precedence over the HOSTNAME/DOMAIN pair. The HOSTNAME and DOMAIN lines can each contain a single semicolon if a group is to be used. Bugs should be reported to johna@onevista.com johna@onevista.com August 2001