English • Русский


freedns-afraid

freedns-afraid is a dynamic DNS client or updater: a Linux daemon which keeps your record on free dynamic DNS freedns.afraid.org up-to-date. rpm is build for Fedora, but it should work for other rpm-based Linux distros which use systemd and NetworkManager. freedns-afraid is free software.

Contents

Quick start

Install the package:

# yum install https://sourceforge.net/projects/freedns-afraid/files/v0.10/freedns-afraid-0.10-1.fc20.noarch.rpm

Write down your hash:

# vi /etc/freedns-afraid.conf

Enable and start the daemon:

# systemctl enable freedns-afraid; systemctl start freedns-afraid

All the commands above should be executed as root.

Purpose

Nowadays Internet Service Providers (ISPs) assign your home computer an IP address dynamically via DHCP. This eliminates configuration burden but makes difficult to access your home computer from office or school, because your home computer does not have a name while IP address is unreliable due to its dynamic nature.

If you could assign a name to your home computer… You can! freedns.afraid.org is a free dynamic DNS. Just follow the simple procedure:

  1. Register at freedns.afraid.org;
  2. Choose a domain from the list of available domains;
  3. Specify name of your home computer;
  4. Update your DNS record.

Steps from 1 to 3 should be done once. But step 4 should be performed every time your computer receives new IP address from your ISP. It is a job for a dynamic DNS client, and freedns-afraid is one of clients.

Features

What is good in freedns-afraid:

What is not so good (but not so bad):

Other clients

At freedns.afraid.org site there is a list of dynamic DNS clients. (As of April 2013) The list includes 6 Windows/Unix clients, and 16 Unix clients. Why did I write one more? Well, see the features

Download

If you use yum program or web browser, explicit downloading is not really necessary, see the next section.

However, rpm, source rpm, and tarball are available to download. Few previous releases also available.

Install

Obviously, for installing the package you will need root privileges. Use yum command to download and install the package:

# yum install https://sourceforge.net/projects/freedns-afraid/files/v0.10/freedns-afraid-0.10-1.fc20.noarch.rpm

freedns-afraid requires some more packages, all them are available in Fedora repositories. yum will resolve dependencies and offer to download all the required packages.

If you work in graphical environment, just click on the link above, then choose Open (not Save); you wil be prompted for the root password and the package will be installed.

Note: The freedns-afraid daemon does not start automatically after installation because you have to configure it first.

Configuration

Configuration file

The service configuration file is /etc/freedns-afraid.conf. The file contains two configuration variables:

hash = str
Your identification string. This is a mandatory variable, you have to specify hash to let freedns-afraid update your DNS record. See Getting hash below.
interval = int
Interval between updates, in minutes. This is optional; by default freedns-afraid updates your DNS record every 15 minutes. Do not specify too short interval, avoid disturbing freedns.afraid.org too frequently: regardless of the specified interval your record is updated as soon as your computer connects to the internet and/or its IP address is changed.

Getting hash

First, you have to complete registration at freedns.afraid.org. Then, open http://freedns.afraid.org/ in a browser, click on Dynamic DNS item in the menu on the left (log in if you are not logged in yet), and find Direct URL link. Check the link target, it looks like

http://freedns.afraid.org/dynamic/update.php?EV01mZ6TFVRNMG8BQUVuRWxRrTo1Mj

Everything after question mark is your hash. This string identifies you at freedns.afraid.org. Copy it (hash only, not entire URL) to the configuration file. Do not forget to update hash in configuration file each time you change your password at freedns.afraid.org.

Enabling the service

After you specify your hash value, configure systemd to start freedns-afraid daemon when network is ready:

# systemctl enable freedns-afraid

If you want freedns-afraid to start immediately, run:

# systemctl start freedns-afraid

Support

If you found a bug or have a request, please submit a bug report or a feature request. Questions are welcome at discussion forums.

Sorry, anonymous posts are not allowed. You have to register at SourceForge to create a new ticket or forum post.

License

Copyright (C) 2010–2014 .

freedns-afraid is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

freedns-afraid is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with freedns-afraid. If not, see http://www.gnu.org/licenses/.