Easily keep your Google Domains Synthetic Record up to date with your Dynamic IP.
dynamic-ip-updater-google-domains is a small and easy project made with python3 that intents to help you keep your Google Domains Synthetic Record pointing to your machine when you have a dynamic IP from your ISP.
Originally designed by Henrique Bontempo.
If you want to access you home network through a VPN, host your own website, host a game server, have remote access to our security cameras or any other task that you have to access your home network from the internet you must have to locate it .
The most direct way is through your public IP , and it's easy if you have a static IP, but they are expensive and for many regions almost exclusive to business. If your ISP won't provide static IP on your location or you don't want to pay for it than you are stuck with a dynamic IP. You still can reach your home through your external IP, but there are no guarantees that this address won't change without a notice.
To circumvent this problem the most common idea is to use a url address that is constantly updated your external IP. You can hire a service for this like no-ip and they do a grate job, but if you want advance control or even some simple things like using your custom domain are paid and sometimes even require you to transfer your domain their platform.
[TODO] Put reference to inspiration article.
This project have a direct purpose: with just a domain in Google Domains keep a subdomain pointing to your home without worrying with static IP or ane other paid service. Just a small script running on your computer.
It's meant to do a simple and very specific function: monitor changes on it's current external IP and, if a change is noticed, update the domain on Google Domains Synthetic Records.
You must have a domain in Google Domain (if you don't have one you can buy one or transfer your domain) and must set up a Dynamic DNS synthetic record a get it's credentials (detailed steps: https://support.google.com/domains/answer/6147083?hl=en).
Cloning this project requires git, instructions provided below.
Check clone with https for further information.
$ git clone https://github.com/hbontempo-br/dynamic-ip-updater-google-domains.git
Check clone with ssh for further information.
$ git clone [email protected]:hbontempo-br/dynamic-ip-updater-google-domains.git
Install dependencies (setting up a virtual environment is recommended):
With pip:
$ pip3 install requirements.txt
Make sure you have the following environment variables set:
- USERNAME=<your_domains_username>
- PASSWORD=<your_domains_password>
- HOSTNAME=<your_domain>
- UPDATE_DELAY=<[optional]seconds_between_verifications>
Then just run the app.py:
$ python3 app.py
๐ง ๐ง ๐ง ๐ง ๐ง Testing this project requires ..., instructions provided below.
$ echo 'instructions'
The latest image of this project can be found on in DockerHub, but you can build it yourself:
$ docker build -t dynamic-ip-updater-google-domains -f Dockerfile .
It the recommended way, just use the environment variables described above:
$ docker run \
-e USERNAME=<your_domains_username> \
-e PASSWORD=<your_domains_password> \
-e HOSTNAME=<your_domain> \
-e UPDATE_DELAY=<[optional]seconds_between_verifications> \
--restart=always \
-d hbontempo/dynamic-ip-updater-google-domains
It's a good practice to run your this container with a --restart=always
as showed above so your container
starts running again even if a problem happens.
๐ง ๐ง ๐ง ๐ง ๐ง Packing this project requires ..., instructions provided below.
$ echo 'instructions'
This project is originally designed by Henrique Bontempo. Check the contributors list for further information.
This project has some rules, a code of conduct, and a process for submitting code and pull requests. Check the contributing file for further information.
This project follows semantic versioning and keep a changelog practices. Changelog files should be provided in a per release basis using these practices.
This project is licensed under the MIT license. Check the license file for further information.