Skip to content

Installation from binary

Download

ddns-route53 binaries are available on releases page.

Choose the archive matching the destination platform:

And extract ddns-route53:

wget -qO- https://github.com/crazy-max/ddns-route53/releases/download/v2.12.0-1-gcca04a2/ddns-route53_2.12.0-1-gcca04a2_linux_amd64.tar.gz | 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

Configuration

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