Skip to main content

Update Route53 domains.

Project description

Route53 domain updates for humans named Matt. At least it works for him. You might find it useful too.


With pip:

$ pip install roadtrip

With setuptools:

$ easy_install roadtrip


Roadtrip requires Python 2.7 and leans heavily on the shoulders of Boto 2.25.0+.


You can use roadtrip to update a round-robin A record, adding a new value if it doesn’t already exist:

$ roadtrip --type A --zone --name --value --add

There is also a compact syntax for each option:

$ roadtrip -t A -z -n -v -a

You can also remove a value from a list:

$ roadtrip --type A --zone --name --value --delete

You can also get help:

$ roadtrip -h
usage: roadtrip [-h] --type {A,AAAA,CNAME,MX,NS,PTR,SOA,SPF,SRV,TXT} --zone
                ZONE --name NAME --value VALUE [--ttl TTL] (--add | --delete)
                [--access-key ACCESS_KEY] [--secret-key SECRET_KEY]

Update a Route53 record, adding or removing values.

optional arguments:
  -h, --help            show this help message and exit
                        The type of record to update.
  --zone ZONE, -z ZONE  The domain name or zone ID.
  --name NAME, -n NAME  The name to update.
  --value VALUE, -v VALUE
                        The data to add or remove.
  --ttl TTL, -l TTL     Non-default TTL value.
  --add, -a             Add the value.
  --delete, -d          Remove the value.
  --access-key ACCESS_KEY, -k ACCESS_KEY
                        Your AWS access key. Will override the
                        AWS_ACCESS_KEY_ID environment variable.
  --secret-key SECRET_KEY, -s SECRET_KEY
                        Your AWS secret key. Will override the
                        AWS_SECRET_ACCESS_KEY envionrment variable.
  --verbose, -vv        Verbose output.

You can set a non-default TTL value with --ttl and enable verbose output with --verbose.

Roadtrip will use the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables if they are set. You can provide these values yourself or override the environment variables by providing --access-key and --secret-key.

Under the hood

Roadtrip will do its best not to add an entry that already exists or delete an entry that doesn’t. It uses UPSERT to update the values based on the values that exist when you call it.


Due to the nature of eventual consistency there is a chance that the values that roadtrip sees when it is run are different than the values stored in Route53. ROADTRIP MIGHT HELP YOU LOSE DATA if you are not careful. Please be careful.

Project details

Release history Release notifications

History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
roadtrip-0.2.1-cp27-none-macosx_10_9_x86_64.whl (6.0 kB) Copy SHA256 hash SHA256 Wheel 2.7 Feb 18, 2014
roadtrip-0.2.1.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None Feb 18, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page