Skip to content

Installation from binary


ddns-route53 binaries are available on releases page.

Choose the archive matching the destination platform:

And extract ddns-route53:

wget -qO- | tar -zxvf - ddns-route53

After getting the binary, it can be tested with ./ddns-route53 --help command and moved to a permanent location.

Server configuration

Steps below are the recommended server configuration.

Prepare environment

Create user to run ddns-route53 (ex. ddns-route53)

groupadd ddns-route53
useradd -s /bin/false -d /bin/null -g ddns-route53 ddns-route53

Create required directory structure

mkdir -p /var/lib/ddns-route53
chown ddns-route53:ddns-route53 /var/lib/ddns-route53/
chmod -R 750 /var/lib/ddns-route53/
mkdir /etc/ddns-route53
chown ddns-route53:ddns-route53 /etc/ddns-route53
chmod 770 /etc/ddns-route53


Create your first configuration file in /etc/ddns-route53/ddns-route53.yml and type:

chown ddns-route53:ddns-route53 /etc/ddns-route53/ddns-route53.yml
chmod 644 /etc/ddns-route53/ddns-route53.yml

Copy binary to global location

cp ddns-route53 /usr/local/bin/ddns-route53

Running ddns-route53

After the above steps, two options to run ddns-route53:

See how to create Linux service to start ddns-route53 automatically.

2. Running from terminal

/usr/local/bin/ddns-route53 \
  --config /etc/ddns-route53/ddns-route53.yml \
  --schedule "*/30 * * * *"

Updating to a new version

You can update to a new version of ddns-route53 by stopping it, replacing the binary at /usr/local/bin/ddns-route53 and restarting the instance.

If you have carried out the installation steps as described above, the binary should have the generic name ddns-route53. Do not change this, i.e. to include the version number.

Last update: 2022-01-26 16:50:07
Created: 2020-07-22 09:34:17