{"id":13626257,"url":"https://github.com/mthssdrbrg/ddns-route53","last_synced_at":"2026-03-05T22:20:50.449Z","repository":{"id":45177694,"uuid":"48871562","full_name":"mthssdrbrg/ddns-route53","owner":"mthssdrbrg","description":"Dynamic DNS updater using AWS Route53","archived":false,"fork":false,"pushed_at":"2022-01-03T15:00:58.000Z","size":47,"stargazers_count":82,"open_issues_count":1,"forks_count":23,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-08T16:42:54.503Z","etag":null,"topics":["aws","ddns","dns","route53"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mthssdrbrg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-01T06:45:55.000Z","updated_at":"2024-10-16T19:19:12.000Z","dependencies_parsed_at":"2022-09-24T19:50:39.027Z","dependency_job_id":null,"html_url":"https://github.com/mthssdrbrg/ddns-route53","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthssdrbrg%2Fddns-route53","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthssdrbrg%2Fddns-route53/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthssdrbrg%2Fddns-route53/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mthssdrbrg%2Fddns-route53/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mthssdrbrg","download_url":"https://codeload.github.com/mthssdrbrg/ddns-route53/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249250820,"owners_count":21237961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","ddns","dns","route53"],"created_at":"2024-08-01T21:02:14.093Z","updated_at":"2026-03-05T22:20:50.416Z","avatar_url":"https://github.com/mthssdrbrg.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# ddns-route53\n\n[![Build Status](https://travis-ci.org/mthssdrbrg/ddns-route53.svg?branch=main)](https://travis-ci.org/mthssdrbrg/ddns-route53)\n[![GitHub Release](https://img.shields.io/github/release/mthssdrbrg/ddns-route53.svg)]()\n\nSimple dynamic DNS updater script using Amazon Route53.\n\nSource is originally from [Roll your own dynamic DNS service using Amazon Route53](https://willwarren.com/2014/07/03/roll-dynamic-dns-service-using-amazon-route53)\nthough it's been modified to use OpenDNS for getting the current IP address, as\nwell as usage of command line arguments and environment variables.\n\n## Requirements\n\n* `bash`\n* `awscli`\n* `dig`\n\n## Installation\n\n```shell\ncurl -sLO https://github.com/mthssdrbrg/ddns-route53/raw/$VERSION/ddns-route53\n```\n\nThe following IAM policy (or something similar) will have to be applied to an user or role.\nUnfortunately it's not possible to restrict access to specific resource record (yet), but\na workaround is to create a \"sub\" hosted zone for a specific record.\n\n```json\n{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Action\": [\n        \"route53:ChangeResourceRecordSets\",\n        \"route53:ListResourceRecordSets\"\n      ],\n      \"Effect\": \"Allow\",\n      \"Resource\": \"arn:aws:route53:::hostedzone/EXAMPLE\"\n    }\n  ]\n}\n```\n\n## Usage\n\n```shell\n$ ddns-route53 --zone-id \u003cZONE_ID\u003e --record-set \u003cRECORD_SET\u003e\n```\n\n\u003e Note: long options on the form `--long-option=` are not supported.\n\nThe above command assumes that the necessary environment variables for `awscli`\nare set, an A type record and a TTL of 300 seconds.\n\nSee `ddns-route53 --help` for more information about command line arguments.\n\nIt's possible to set a number of environment variables instead of using command\nline arguments, though command line arguments take precedence over environment\nvariables.\n\n* `DDNS_ROUTE53_TTL`: TTL for DNS record.\n* `DDNS_ROUTE53_TYPE`: DNS record type.\n* `DDNS_ROUTE53_COMMENT`: comment set when updating the Route53 record (only\n  configurable as environment variable).\n* `DDNS_ROUTE53_ZONE_ID`: Amazon Route53 hosted zone ID.\n* `DDNS_ROUTE53_RECORD_SET`: Amazon Route53 record set name.\n* `DDNS_ROUTE53_SCRIPT`: path to script to execute on changes.\n\n## Copyright\n\nThis is free and unencumbered software released into the public domain.\n\nSee LICENSE.txt or [unlicense.org](http://unlicense.org) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmthssdrbrg%2Fddns-route53","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmthssdrbrg%2Fddns-route53","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmthssdrbrg%2Fddns-route53/lists"}