🗝
about summary refs log tree commit diff
path: root/README.md
blob: 78d866baace96e4b1483dcda571c3fd5701ddb5e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# zoner
declarative dns management for porkbun

# configuration
create porkbun api credentials and insert them into `~/.config/zoner/zoner.toml` like in [example/zoner.toml](example/zoner.toml). then just run `zoner <domain>`, insert your data in the same format as [example/example.com.zone](example/example.com.zone). note that you need tabs between values, not spaces, but you can repeat tabs as much as you'd like

# hook
see [example/hook](example/hook) for an example hook that automatically purges dns entries from cloudflare

# git
if you initialize a git repository in your configuration directory, zoner will automatically create and push commits for you every time you change anything. if you just wanna put that git repo *somewhere* on *a* server, you can use git over ssh and bare repositories without any sort of sophisticated server software. just a little directory on a server somewhere that contains your dns zones!

# contact
issues? praise? patches? death threats? death *promises*? send an email to [mia@mia.jetzt](mailto:mia@mia.jetzt)!