Create README.md
This commit is contained in:
27
README.md
Normal file
27
README.md
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
# Porkbun Dynamic DNS Client
|
||||||
|
|
||||||
|
This repository contains a [Nix](https://nixos.org/nix/) flake that wraps the Python version of the [Porkbun Dynamic DNS](https://github.com/porkbun-ddns/porkbun-ddns) client.
|
||||||
|
|
||||||
|
Currently skoobasteeve's [fork](https://github.com/skoobasteeve/porkbun-dynamic-dns-python/tree/ddns-no-delete-unless-change) is used.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Once the flake is installed, you can call the `porkbun-ddns` script like this:
|
||||||
|
|
||||||
|
~~~
|
||||||
|
porkbun-ddns </path/to/config_file.json> <root domain> <optional: subdomain>
|
||||||
|
~~~
|
||||||
|
|
||||||
|
|
||||||
|
The `config_file.json` should contain your Porkbun API key and other settings. The `root domain` and `subdomain` arguments are used to specify the domain you want to update.
|
||||||
|
|
||||||
|
For example, if you want to update the IP address for the subdomain `home` of the domain `example.com`, you would run the following command:
|
||||||
|
|
||||||
|
~~~
|
||||||
|
porkbun-ddns /path/to/config.json example.com home
|
||||||
|
~~~
|
||||||
|
|
||||||
|
|
||||||
|
## Additional Information
|
||||||
|
|
||||||
|
Please refer to the [Porkbun Dynamic DNS](https://github.com/porkbun-ddns/porkbun-ddns) for further information on how to use the client.
|
||||||
Reference in New Issue
Block a user