Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
For maintaining a dynamic-IP server's IP entry in a static-IP server's hosts file. Similar to DDNS or what no-ip provides--but if you already have a VPS why use those services for running another server from your home? I wrote this script and it did the trick for me.
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


  This script is run on a computer (slave) with a non-static IP address. 
  It will check the IP address and, if it has changed, will connect to the server (master) that maintains a record of the slave's IP via SSH and update the /etc/hosts file with the slave's IP and hostname.

  Master: A server that contains the slave's IP address in its /etc/hosts file (for easy use in Apache proxies, etc). The master has a static IP address.
  Slave: The slave has a non-static IP address and uses this script for updating it in the /etc/hosts file of the master.

  1) Place the public key of the slave into the ~/.ssh/authorized_keys folder for the master's root user (unless some other user can edit /etc/hosts)
  2) Remove any existing mentions of the slave from your master hosts file.
  3) Open the settings.yaml and fill the fields:
    master: and enter the hostname or ip address for master server.
    name: enter a hostname you want the master to use in its hosts file for this computer
    lastip: leave this blank, it is used to determine if the master should be updated.
  4) Run the script for the first time. It will add your slave's current IP to the master's hosts file in a proper format. You can run it again and again (see the cron entry below) and it will simply update if your ip has changed.
  NOTE: It is designed to support multiple independent slaves on one master, but that's untested.
  The script is super simple and takes no arguments, you run it like so:
  To set up your system to check and update periodically, set it up to run with cron, which would use a command like this:
  */15 * * * * su - yourusername -c "/path/to/ipchanged.rb"

Example Cron:
  */15 * * * * su - keyvan -c "ruby /opt/ipchanged/ipchanged.rb"
  This script edits /etc/hosts file as root! Use with caution. I'm not responsible if something bad happens!
Something went wrong with that request. Please try again.