/route-53-dyndns

Provide a simple dynamic DNS service using domain A (alias) records by leveraging the Amazon Route53 API.

Primary LanguagePython

Amazon Route53 Dynamic DNS Tool

Provide a simple dynamic DNS creation and update service via Amazon Route53 and A (alias/subdomain) records.

Dependencies

Docker

Familiar with Docker? A docker image was created to deploy this service extremely quickly.

QuickStart

  1. Clone this repository

     git clone git://github.com/JacobSanford/route-53-dyndns.git
 cd route-53-dyndns

  2. Install dependencies (virtualenv is recommended.)

     pip install -r requirements.txt

  3. Export environment variables

    export AWS_ACCESS_KEY_ID="<Insert your AWS Access Key>"
export AWS_SECRET_ACCESS_KEY="<Insert your AWS Secret Key>"
export AWS_CONNECTION_REGION="us-east-1"
(optional) export ROUTE53_ZONE="<Insert zone name>"

    If ROUTE53_ZONE is not defined, base domain (TLD + 1) is used, e.g. example.com.

  4. Run the script

     ./r53dyndns.py -U http://www.whatismyip.com/ -R example.domain.com

Running as a 'Service'

Users would benefit from running this tool periodically. On linux systems, one option to do so is through the cron system.

  1. Create a calling script

     > vi /etc/cron.hourly/updateDynDNS

 #!/usr/bin/env bash
 export AWS_ACCESS_KEY_ID=""
 export AWS_SECRET_ACCESS_KEY=""
 export AWS_CONNECTION_REGION="us-east-1"
 /var/opt/route-53-dyndns/r53dyndns.py -U http://www.whatismyip.com/ -R example.domain.com

  2. Create a calling script

     chmod +x /etc/cron.hourly/updateDynDNS

  3. (Test by running script directly)

     > /etc/cron.hourly/updateDynDNS

License