{"id":27840209,"url":"https://github.com/caldito/ipwarn","last_synced_at":"2025-07-28T15:11:41.838Z","repository":{"id":113497958,"uuid":"197072698","full_name":"caldito/ipwarn","owner":"caldito","description":"A simple dynamic DNS update client.","archived":false,"fork":false,"pushed_at":"2022-12-29T17:27:30.000Z","size":32,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-06T23:38:54.593Z","etag":null,"topics":["bash","dns-records","dynamic-dns","godaddy","linux","self-hosted","shell","telegram-bots","unix"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/caldito.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-07-15T21:08:10.000Z","updated_at":"2022-12-30T09:13:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"e56be979-9aaa-495b-8c14-cd32883d1cea","html_url":"https://github.com/caldito/ipwarn","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/caldito/ipwarn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caldito%2Fipwarn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caldito%2Fipwarn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caldito%2Fipwarn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caldito%2Fipwarn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caldito","download_url":"https://codeload.github.com/caldito/ipwarn/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caldito%2Fipwarn/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267535952,"owners_count":24103399,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"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":["bash","dns-records","dynamic-dns","godaddy","linux","self-hosted","shell","telegram-bots","unix"],"created_at":"2025-05-03T03:43:59.032Z","updated_at":"2025-07-28T15:11:41.805Z","avatar_url":"https://github.com/caldito.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ipwarn\n\nA simple Dynamic DNS Update Client written in Bash.\n\nThe purpose of this project is to be able to update DNS records of the main hosting providers directly and also provide other functionalities like notifiying through Telegram.\n\nFor now it is able to update Godaddy's DNS records and notify using Telegram Bots.\n\n## Prerequisites :clipboard:\n\nIn order to work ipwarn needs `curl`.\n\n## Configuration :gear:\nThis software needs to use the APIs of different services. Due to this in the config file `/etc/ipwarn/ipwarn.conf` you can choose the services to enable and store the tokens for those. The configs inside this file are quite self descriptive, so I won't go into details here.\n\nWith the flag `-c` or `--config` you can override the default location of this file.\n\n## Running :running:\n\n### Docker\n```\ndocker run --mount type=bind,source=your-custom-ipwarn.conf,target=/etc/ipwarn/ipwarn.conf pablogcaldito/ipwarn:v1.0.1\n```\n### Systemd install\nRun the install script\n```\ncurl -O https://raw.githubusercontent.com/caldito/ipwarn/master/config/ipwarn-systemd-easy-install.sh \u0026\u0026 sudo bash ./ipwarn-systemd-easy-install.sh\n```\nOverride the config found in `/etc/ipwarn/ipwarn.conf`\n\nRestart the service\n```\nsudo systemd restart ipwarn.service\n```\n\n### Standalone run\n\nAfter clonning the repo go into its directory and run:\n./ipwarn --config your-config-file\n\n\n## Built with :hammer_and_wrench:\n\n* [Telegram Bot API](https://core.telegram.org/bots/apis) - Used to notify when IP changes\n* [GoDaddy API](https://developer.godaddy.com/) - Used to update DNS records in GoDaddy\n\n## Contributing :handshake:\n\nPlease read [CONTRIBUTING.md](https://github.com/caldito/ipwarn/blob/master/CONTRIBUTING.md) for details on the process for submitting pull requests to the project.\n\nAlso read [CODE_OF_CONDUCT.md](https://github.com/caldito/ipwarn/blob/master/CODE_OF_CONDUCT.md) for details on the code of conduct.\n\n## Authors :black_nib:\n\nSee the [contributors](https://github.com/caldito/ipwarn/graphs/contributors) page.\n\n## License :balance_scale:\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/caldito/ipwarn/blob/master/LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaldito%2Fipwarn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaldito%2Fipwarn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaldito%2Fipwarn/lists"}