summaryrefslogtreecommitdiff
path: root/README.md
blob: dd41b029ea1505340077dc3eb2518ab7f5790ad2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# simpleddns

Very simple DDNS client with support for

- Linode, DigitalOcean, and AWS Route 53 providers.
- Allows obtaining IP address via any shell command.
- Customize TTL, API call interval & timeout.
- Multiple domains.

Run `install.sh` to install.
Then run `simpleddns --setup` to create a configuration interactively.
Lastly run `simpleddns` to start the DDNS client.
Currently only Unixy platforms are supported (i.e. not Windows, but maybe WSL or MinGW or something).


## Alternatives

This particular set of features is somewhat unique.
But there are other DDNS clients out there:

- [godns](https://github.com/TimothyYe/godns)
- [ddclient](https://github.com/ddclient/ddclient)


## Example systemd service

(This assumes a user `simpleddns` has installed the program.)

```
[Unit]
Description=Simple DDNS client
After=network.target
 
[Service]
Restart=always
RestartSec=20
User=simpleddns
WorkingDirectory=~
ExecStart=/bin/sh -c .local/bin/simpleddns
 
[Install]
WantedBy=multi-user.target
```