https://github.com/akrantz01/dns
A custom DNS server with a web UI
https://github.com/akrantz01/dns
boltdb dns-server golang react
Last synced: about 1 year ago
JSON representation
A custom DNS server with a web UI
- Host: GitHub
- URL: https://github.com/akrantz01/dns
- Owner: akrantz01
- Created: 2020-03-16T03:54:22.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T10:15:31.000Z (over 3 years ago)
- Last Synced: 2025-01-27T15:51:31.208Z (over 1 year ago)
- Topics: boltdb, dns-server, golang, react
- Language: Go
- Size: 4.48 MB
- Stars: 8
- Watchers: 2
- Forks: 6
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DNS
A custom DNS server that can dynamically add and remove records through a web UI backed by a REST API.
It uses [Bolt](https://github.com/etcd-io/bbolt) for storage and [Miekg DNS](https://github.com/miekg/dns) for, well, DNS.
## Configuration
All configuration is done through a YAML file.
An example configuration file with descriptions of each field can be found at [`config.sample.yaml`](/config.sample.yaml).
## Deployment
The server can be deployed via either Docker or a standalone binary.
All assets are bundled with the binary, so all you need to do is compile it.
The Docker image is on [Docker Hub](https://hub.docker.com/r/akrantz/dns) and the binary can be download from the [releases](https://github.com/akrantz01/krantz.dev/releases) page.
The server looks for a configuration file named `config.yaml` in either the user's home directory or the working directory.
To pass the configuration file to the Docker container run it with the argument: `-v /path/to/config.yaml:/config.yaml:ro`.