{"id":13587408,"url":"https://github.com/WillFantom/agh-updater","last_synced_at":"2025-04-07T21:33:53.781Z","repository":{"id":128464354,"uuid":"489611934","full_name":"WillFantom/agh-updater","owner":"WillFantom","description":"Sync AdGuard Home TLS certs with Træfik generated certs","archived":false,"fork":false,"pushed_at":"2022-05-08T17:43:39.000Z","size":21,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-23T13:36:47.141Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WillFantom.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-05-07T08:11:38.000Z","updated_at":"2022-09-08T18:20:54.000Z","dependencies_parsed_at":"2024-02-13T21:59:10.044Z","dependency_job_id":null,"html_url":"https://github.com/WillFantom/agh-updater","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WillFantom%2Fagh-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WillFantom%2Fagh-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WillFantom%2Fagh-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WillFantom%2Fagh-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WillFantom","download_url":"https://codeload.github.com/WillFantom/agh-updater/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247732923,"owners_count":20986956,"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":[],"created_at":"2024-08-01T15:06:11.890Z","updated_at":"2025-04-07T21:33:53.453Z","avatar_url":"https://github.com/WillFantom.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# AdGuard Home Settings Updater\n\nThis script can manage your AdGuard Home settings at regular intervals:\n\n - Keep your block/allow lists updated, executing the list refresh on each run\n - Sync your TLS cert settings with Træfik\n\n---\n\n## AdGuard Home + Træfik\n\nAlways ensure your AdGuard Home TLS settings are in sync with your Træfik generated certs!\n\n---\n\nIf you use [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) for DoH/DoQ/DoT, and you use Træfik Proxy + Lets Encrypt to automatically generate certs for your AdGuard domain, you will know that it can be annoying when your certs expire and you have to go diving in your Træfik certs file to find and decode your cert and key for AdGuard... It's a whole 2-minute task every few months!! If you just can't deal with that pain, this is for you 🫵\n\n## Usage [with docker 🐳]\n\nSimply run the container with your credentials and paths set up:\n\n```bash\ndocker run --rm -d --name agh-updater -v /services/traefik/certs:/traefikcerts:ro \\\n  -e ADGUARD_USERNAME=exampleuser -e ADGUARD_PASSWORD=asecret \\\n  -e ADGUARD_DOMAIN=adguard.example.com -e TRAEFIK_CERT_JSON=/traefikcerts/acme.json \\\n  ghcr.io/willfantom/agh-updater:latest\n```\n\n## Usage [with docker compose 🐳]\n\nSee the example setup [here](/example/docker-compose.yml)!\n\n## Usage [bash]\n\n```bash\n  ./agh-updater.sh -u exampleuser -p asecret \\\n    -d adguard.example.com -f /services/traefik/certs/acme.json\n```\n\n## Configuration\n\n|                ENV Variable                | CLI Parameter |                         Description                          |      Default       | Required |\n| :----------------------------------------: | :-----------: | :----------------------------------------------------------: | :----------------: | :------: |\n|             `ADGUARD_USERNAME`             |    `-u \u003c\u003e`    |       Your AdGuard Home admin username for API access        |        N/A         |    ✅     |\n|             `ADGUARD_PASSWORD`             |    `-p \u003c\u003e`    |       Your AdGuard Home admin password for API access        |        N/A         |    ✅     |\n|              `ADGUARD_DOMAIN`              |    `-d \u003c\u003e`    |      Your AdGuard Home domain (without scheme or port)       |        N/A         |    ✅     |\n|            `TRAEFIK_CERT_JSON`             |    `-f \u003c\u003e`    |            Path to your Træfik cert storage file             |        N/A         |    ✅     |\n|       `INTERVAL` \u003cbr\u003e (Docker only)        |    `-i \u003c\u003e`    |   ReUpdate the certs every X seconds (`0` if do only once)   | 0 (`60` in Docker) |    ❌     |\n|                                            |     `-e`      |         Exit update loop if an error is encountered          |      not-set       |    ❌     |\n|            `ADGUARD_API_SCHEME`            |               |      Scheme to use to access your AdGuard instance API       |      `https`       |    ❌     |\n|             `ADGUARD_API_PORT`             |               |           Port to access your AdGuard instance API           |       `443`        |    ❌     |\n|                                            |     `-h`      |                        Print CLI Help                        |                    |    ❌     |\n| `TRAEFIK_CERT_RESOLVER` \u003cbr\u003e (Docker only) |               | Name of the certificate resolver used for the adguard domain |     `[]` (any)     |    ❌     |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWillFantom%2Fagh-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWillFantom%2Fagh-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWillFantom%2Fagh-updater/lists"}