{"id":34882838,"url":"https://github.com/gabriel-duque/zorua","last_synced_at":"2026-05-06T04:07:20.405Z","repository":{"id":57597195,"uuid":"271275234","full_name":"gabriel-duque/zorua","owner":"gabriel-duque","description":"a simple Go client to update dynamic DNS records for Google Domains","archived":false,"fork":false,"pushed_at":"2020-11-03T13:41:08.000Z","size":47,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-15T04:43:03.997Z","etag":null,"topics":["amd64","arm","arm64","docker","docker-image","dynamic-dns","dynamic-dns-client","dynamic-dns-updater","golang","google-domains","google-domains-ip-updater","helm-chart","i386"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gabriel-duque.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-06-10T12:48:16.000Z","updated_at":"2022-08-20T09:55:27.000Z","dependencies_parsed_at":"2022-08-24T21:41:22.750Z","dependency_job_id":null,"html_url":"https://github.com/gabriel-duque/zorua","commit_stats":null,"previous_names":["zuh0/zorua"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/gabriel-duque/zorua","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriel-duque%2Fzorua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriel-duque%2Fzorua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriel-duque%2Fzorua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriel-duque%2Fzorua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabriel-duque","download_url":"https://codeload.github.com/gabriel-duque/zorua/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriel-duque%2Fzorua/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32677956,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T02:33:58.958Z","status":"ssl_error","status_checked_at":"2026-05-06T02:33:39.611Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["amd64","arm","arm64","docker","docker-image","dynamic-dns","dynamic-dns-client","dynamic-dns-updater","golang","google-domains","google-domains-ip-updater","helm-chart","i386"],"created_at":"2025-12-26T02:55:47.432Z","updated_at":"2026-05-06T04:07:20.396Z","avatar_url":"https://github.com/gabriel-duque.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zorua [![GitHub license](https://img.shields.io/github/license/zuh0/zorua.svg)](https://github.com/zuh0/zorua/blob/master/LICENSE.md) [![Go Report Card](https://goreportcard.com/badge/github.com/zuh0/zorua)](https://goreportcard.com/report/github.com/zuh0/zorua) [![Docker image size](https://img.shields.io/docker/image-size/zuh0/zorua/latest)](https://hub.docker.com/r/zuh0/zorua) [![Docker pulls](https://img.shields.io/docker/pulls/zuh0/zorua)](https://hub.docker.com/r/zuh0/zorua/)\n\na simple Go client to update dynamic DNS synthetic records for Google Domains.\n\n## Building\n\nIn order to build `zorua` you can just:\n\n```\n$ cd cmd/zorua \n$ go build\n```\n\nThis will produce an executable file called `zorua` which you can run directly.\n\n## Usage\n\n```\nUsage of ./zorua:\n  -config string\n    \tpath to the JSON configuration file (default \"/etc/zorua/config.json\")\n```\n\nThe configuration file is a simple JSON-serialized file which should look like this:\n\nThe Username and Password entries are the ones generated by Google Domains when\nyou create your [synthetic record for dynamic DNS](https://support.google.com/domains/answer/6147083?hl=en).\n\n```\n{\n  \"Domain\": \"test.example.com\",\n  \"Credentials\": {\n    \"Username\": \"TestUsername\",\n    \"Password\": \"TestPassword\"\n  }\n}\n```\n\n## Docker\n\nIn order to ease the installation of `zorua` in cloud native environments, you\ncan use the provided Docker image.\n\nThis tiny image is built nightly to pull in updates to the `golang` Docker\nimage and is a multi-architecture image working for the following\narchitectures:\n\n* x86\n* x86_64\n* armv6\n* armv7\n* armv8 (aarch64)\n\n```\n$ docker run -v /path/to/zorua-config.json:/etc/zorua/config.json:ro zuh0/zorua\n```\n\n## Helm\n\nA helm chart for `zorua` is available in [this](https://github.com/zuh0/sadm)\nrepository.\n\nTo install the helm chart you can simply create your own values file\n`my-values.yaml` which could look like this:\n\n```\n# The cronExpression field is optional and will default to this:\ncronExpression: \"*/5 * * * *\"\n\ndomain: example.com\ncredentials:\n  username: MyUsername\n  password: MyPassword\n```\n\nThen install it like this from the root of the `sadm` repository:\n\n```\n$ helm install zorua zorua -f my-values.yaml\n```\n\nThis will setup `zorua` as a Kubernetes cron job checking for an IP update\nevery 5 minutes (you can change this interval by setting the `cronExpression`\nfield in your values file).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabriel-duque%2Fzorua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabriel-duque%2Fzorua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabriel-duque%2Fzorua/lists"}