{"id":31793687,"url":"https://github.com/yorch/ddns-updater","last_synced_at":"2026-05-04T08:40:38.254Z","repository":{"id":51346341,"uuid":"269574209","full_name":"yorch/ddns-updater","owner":"yorch","description":"Dockerized Digital Ocean Dynamic DNS Updater with cron feature","archived":false,"fork":false,"pushed_at":"2025-12-20T05:36:15.000Z","size":31,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-04T08:39:55.951Z","etag":null,"topics":["ddns","ddns-updater","digitalocean","dns","dns-record","docker","docker-compose","python","python3"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yorch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-06-05T08:32:31.000Z","updated_at":"2025-12-20T05:36:19.000Z","dependencies_parsed_at":"2022-08-26T10:41:13.143Z","dependency_job_id":null,"html_url":"https://github.com/yorch/ddns-updater","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yorch/ddns-updater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorch%2Fddns-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorch%2Fddns-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorch%2Fddns-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorch%2Fddns-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yorch","download_url":"https://codeload.github.com/yorch/ddns-updater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorch%2Fddns-updater/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32600967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"online","status_checked_at":"2026-05-04T02:00:06.625Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ddns","ddns-updater","digitalocean","dns","dns-record","docker","docker-compose","python","python3"],"created_at":"2025-10-10T18:30:04.842Z","updated_at":"2026-05-04T08:40:38.249Z","avatar_url":"https://github.com/yorch.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Digital Ocean Dynamic DNS Updater\n\n## Purpose\n\nAllows to dynamically update an 'A' or 'AAAA' record that is managed by Digital Ocean's DNS servers.\n\nMain purpose of this is to keep a known domain for your home IP address. For instance, if your ISP doesn't give you an static IP address, you could run this script with `--run-every` flag, in a cron job or with the Windows Scheduler to keep an always available domain pointing to your home IP.\n\n## Usage\n\nThe script has been designed to be called as a command line tool. Config is passed into it in the form of CLI parameters, for example:\n\n```sh\npython app/updater.py {accessToken} {domain} {record} {recordType} {other args}\n```\n\nWhere:\n\n- `accessToken`: your Digital Ocean ['Personal Access Token'](https://cloud.digitalocean.com/settings/applications)\n- `domain`: the domain name you want to update (e.g: yourdomain.com)\n- `record`: the value of the record you want to update (e.g: home)\n- `recordType`: either A or AAAA\n- `-q` / `--quiet`: quiet mode, only displays output on IP change\n- `-d` / `--debug`: debug mode, shows debug messages\n- `-re {seconds}` / `--run-every {seconds}`: runs continuously every number of seconds\n- `ecoc` / `--error-code-on-change`: returns error code 1 on IP change\n\n### Run Continuously / Cron Style\n\nYou can run this script continuously (every X number of seconds) by calling it like below:\n\n```sh\n# If you wan to run it every 5 minutes\npython app/updater.py {accessToken} {domain} {record} {recordType} --run-every 300\n```\n\n## Docker\n\n### Official Docker Image\n\nYou can use the official Docker image directly from GitHub Container Registry without having to clone this repo.\n\nYou can use the provided [docker-compose.yml](docker-compose.yml) file to run it. Just download the file, create a `.env` file next to it (see [.env.sample](.env.sample) for reference), and run:\n\n```sh\n# Runs the service in detached mode\ndocker-compose up -d\n```\n\nOr if you prefer, you can just use a bash script like the following:\n\n```sh\nIMAGE=ghcr.io/yorch/ddns-updater\nCONTAINER_NAME=ddns-updater\nTOKEN={your token}\nDOMAIN={your domain}\nRECORD={your record}\nRTYPE=A\nRUN_EVERY=300 # Every 5 min\n\ndocker run \\\n    -d \\\n    --name ${CONTAINER_NAME} \\\n    --restart=unless-stopped \\\n    ${IMAGE} \\\n    ${TOKEN} ${DOMAIN} ${RECORD} ${RTYPE} --run-every ${RUN_EVERY}\n```\n\n### Docker build\n\nTo build the image using the provided [Dockerfile](Dockerfile), run the following:\n\n```sh\ndocker build -t ddns-updater .\n```\n\nThen, you can run your new image with something like:\n\n```sh\nIMAGE=ddns-updater\nTOKEN={your token}\nDOMAIN={your domain}\nRECORD={your record}\nRTYPE=A\nRUN_EVERY=300 # Every 5 min\n\ndocker run \\\n    -d \\\n    --restart=unless-stopped \\\n    ${IMAGE} \\\n    ${TOKEN} ${DOMAIN} ${RECORD} ${RTYPE} --run-every ${RUN_EVERY}\n```\n\nOr with Docker Compose:\n\n```yaml\nservices:\n  ddns-updater:\n    image: ddns-updater\n    env_file: .env\n    command: ${TOKEN} ${DOMAIN} ${RECORD} ${RTYPE} --run-every ${RUN_EVERY}\n```\n\nYou can even build it and run it directly with Docker Compose:\n\n```yaml\nservices:\n  ddns-updater:\n    build: .\n    env_file: .env\n    command: ${TOKEN} ${DOMAIN} ${RECORD} ${RTYPE} --run-every ${RUN_EVERY}\n```\n\n## Credits\n\nOriginally forked from: \u003chttps://github.com/bensquire/Digital-Ocean-Dynamic-DNS-Updater\u003e\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyorch%2Fddns-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyorch%2Fddns-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyorch%2Fddns-updater/lists"}