ddns-route53

ddns-route53

Docker app from A75G's Repository

Overview

Dynamic DNS for Amazon Route 53‎ on a time-based schedule

Documentation GitHub release Total downloads Build Status Docker Stars Docker Pulls
Codecov Become a sponsor Donate PayPal

About

ddns-route53 keeps your Amazon Route 53 DNS records in sync with your current public IP address. It is meant for home labs, self-hosted services, and any setup running behind a connection where the WAN IPv4 and/or IPv6 address can change over time.

Run it on a schedule, let it detect your public IP address, and it will update the configured Route 53 records only when needed. It is available as a single executable and a container image.

[!NOTE] Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!

Documentation

Documentation can be found on https://crazymax.dev/ddns-route53/

Contributing

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a PayPal donation to ensure this journey continues indefinitely!

Thanks again for your support, it is much appreciated! :pray:

License

MIT. See LICENSE for more details.

Categories

Download Statistics

8,514,054
Total Downloads
18,427
This Month
24,467
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
crazymax/ddns-route53:latest
Last Updated2026-07-11
First Seen2020-04-09

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

SCHEDULEVariable

CRON expression to schedule ddns-route53 - http://www.cronmaker.com

Default
*/30 * * * *
Value
*/30 * * * *
MAX_RETRIESVariable

Number of retries in case of WAN IP retrieval failure

Default
3
Value
3
LOG_LEVELVariable

Log level output

Default
info
Value
info
LOG_JSONVariable

Enable JSON logging output

Default
false
Value
false
DDNSR53_CREDENTIALS_ACCESSKEYIDVariable

Access Key ID

Default
ABCDEFGHIJKLMNO123456
Value
ABCDEFGHIJKLMNO123456
DDNSR53_CREDENTIALS_SECRETACCESSKEYVariable

Secret Access Key

Default
abcdefgh123456IJKLMN+OPQRS7890+ABCDEFGH
Value
abcdefgh123456IJKLMN+OPQRS7890+ABCDEFGH
DDNSR53_ROUTE53_HOSTEDZONEIDVariable

Host Zone ID

Default
ABCEEFG123456789
Value
ABCEEFG123456789
DDNSR53_ROUTE53_RECORDSSET_0_NAMEVariable

Record Set 0

Default
ddns.example.com.
Value
ddns.example.com.
DDNSR53_ROUTE53_RECORDSSET_0_TYPEVariable

Record Set 0 Type

Default
A
Value
A
DDNSR53_ROUTE53_RECORDSSET_0_TTLVariable

Record Set 0 TTL

Default
300
Value
300