digitalocean-dyndns/README.md

37 lines
1.2 KiB
Markdown
Raw Normal View History

2016-01-23 16:47:35 +00:00
# Dynamic DNS using DigitalOcean's DNS Services
2016-01-23 20:09:58 +00:00
A script that pushes the public IP address of the running machine to DigitalOcean's DNS API's. It requires an existing A record to update.
## Setup
Assuming you already have a DigitalOcean account and your domain associated with it. Just add an A record with desired name and IP address. That's it!
## Usage
Pick one of the options below using the following settings:
* **DIGITALOCEAN_TOKEN:** The token you generate in DigitalOcean's API settings.
* **DOMAIN:** The domain your subdomain is registered at. (i.e. `foo.com` for `home.foo.com`)
* **NAME:** Subdomain to use. (name in A record) (i.e. `home` for `home.foo.com`)
* **SLEEP_INTERVAL:** Polling time in seconds. (default: 300)
### Docker (Recommended)
```
$ docker pull tunix/digitalocean-dyndns
2016-01-23 20:20:28 +00:00
$ docker run -d --name dyndns \
-e DIGITALOCEAN_TOKEN="your_token_here" \
-e DOMAIN="yourdomain.com" \
-e NAME="subdomain" \
-e SLEEP_INTERVAL=2 \
tunix/digitalocean-dyndns
2016-01-23 20:09:58 +00:00
```
### Manual
You can also create a cronjob using below command:
```
$ DIGITALOCEAN_TOKEN="your_token_here" DOMAIN="yourdomain.com" NAME="subdomain" SLEEP_INTERVAL=2 ./dyndns.sh
```