tdns CLI

A powerful, lightweight CLI to manage Technitium DNS server via HTTP API endpoint.

Warning

tnds is not supporting full set of API calls yet and only the ones I initially needed 😄. Contributions are welcome and feel free to check the upstream guide or open an issue/PR!

Note

Full list of API docs and spec is available here.

Important

Because this is the initial (v0) iteration of the CLI, some features maight change and the code quality will improve over time (e.g. tests, re-use, ...).

Installing

1. Download from the releases
2. Run tdns -v to check if it's working correctly.
3. Enjoy!

Usage and 🛠 Setup

Generate a config file with:

tdns init

and update the values for your endpoint!

Or manually create config.json or ~/.tdns/config.json:

{
  "token": "your-api-token",
  "host": "http://localhost:5380"
}

Tip

You can also use:

• --token (-t) and --endpoint (-e) flags
• Environment variable: TDNS_API_TOKEN

💡 Useful commands

Zones

tdns list [--json]
tdns import <zone> --file zone.txt [--json]
tdns export <zone> [--output-dir dir] [--json]
tdns delete <zone>

Records

tdns records get <zone> [--filter A] [--json]

Logs

tdns logs list
tdns logs download <filename> [--output log.txt]
tdns logs delete <filename>
tdns logs deleteAll

Admin (Sessions)

tdns admin list-sessions
tdns admin delete-session --id <partialToken>
tdns admin create-token --user admin --token-name mytoken
admin change-password -i [-p <pass>]
tdns admin check-update

Building and 🧪 Dev

If you want to build your own binarly locally, you can do that by running:

make build

Which should produce a locally executable binary.

Note

You'll need Golang 1.x compiler and Make.

To run tests there is a Makefile target for that as well:

make test

Contributing

Report issues/questions/feature requests on in the issues section.

Full contributing guidelines are covered here.

Authors

• Marko Bevc
• Full contributors list

License 🏷

MPL-2.0 Licensed. See LICENSE for full details.