containers
/
aardvark-dns
mirror of https://github.com/containers/aardvark-dns.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Authoritative dns server for A/AAAA container records. Forwards other request to host's /etc/resolv.conf
1,019 Commits 6 Branches 25 Tags 14 MiB
Rust 57%
Shell 40.3%
Makefile 2.6%
Go to file
openshift-merge-bot[bot] 513be8b5e1
Merge pull request #609 from containers/renovate/libc-0.x 
fix(deps): update rust crate libc to 0.2.174
 		2025-06-18 10:11:57 +00:00
.fmf tmt: initial enablement 2023-10-20 20:38:28 +05:30
.github github: add automatic release action 2025-05-12 20:36:20 +02:00
contrib netavark_cache_groom.sh: fix wrong branch 2024-09-18 16:31:59 +02:00
docs release,make: add rule crate-publish for publishing crates.io 2022-12-07 22:51:49 +05:30
hack ci: ensure tree is clean after build 2025-05-02 15:09:16 +02:00
plans [skip-ci] RPM/TMT: use tests subpackage 2025-02-14 19:57:17 +05:30
rpm [skip-ci] RPM: fix gating.yaml 2025-02-26 18:05:35 +05:30
src make more use of AardvarkError 2025-06-03 15:12:37 +02:00
test test: use ncat not nc 2025-03-13 14:28:13 +01:00
.cirrus.yml ci: ensure tree is clean after build 2025-05-02 15:09:16 +02:00
.gitignore fix github release action 2025-05-13 17:58:52 +02:00
.packit.yaml [skip-ci] RPM/TMT: use tests subpackage 2025-02-14 19:57:17 +05:30
CODE-OF-CONDUCT.md add code of conduct 2023-01-12 14:58:47 +01:00
CONTRIBUTING.md Add link to c/common contributor's guide 2025-03-25 10:09:35 +01:00
Cargo.lock fix(deps): update rust crate libc to 0.2.174 2025-06-17 20:58:42 +00:00
Cargo.toml fix(deps): update rust crate libc to 0.2.174 2025-06-17 20:58:42 +00:00
DISTRO_PACKAGE.md use local cargo dependencies 2022-02-24 15:24:03 +01:00
LICENSE Initial commit 2021-12-08 12:11:43 -06:00
Makefile fix github release action 2025-05-13 17:58:52 +02:00
OWNERS OWNERS: remove edsantiago 2024-11-26 15:20:29 +01:00
README.md Add link to c/common contributor's guide 2025-03-25 10:09:35 +01:00
RELEASE_NOTES.md release notes for v1.15.0 2025-05-13 16:38:22 +02:00
build.rs update chrono package 2024-03-27 08:48:07 -05:00
config.md config,coredns: add support for network scoped dns servers 2022-11-22 21:51:26 +05:30

README.md

aardvark-dns

Aardvark-dns is an authoritative dns server for A/AAAA container records. It can forward other requests to configured resolvers.

Read more about configuration in src/backend/mod.rs. It is mostly intended to be used with Netavark which will launch it automatically if both are installed.

aardvark-dns 0.1.0

USAGE:
    aardvark-dns [OPTIONS] <SUBCOMMAND>

FLAGS:
    -h, --help       Print help information
    -V, --version    Print version information

OPTIONS:
    -c, --config <CONFIG>    Path to configuration directory
    -p, --port <PORT>        Host port for aardvark servers, defaults to 5533

SUBCOMMANDS:
    help    Print this message or the help of the given subcommand(s)
    run     Runs the aardvark dns server with the specified configuration directory

MSRV (Minimum Supported Rust Version)

v1.76

We test that Netavark can be build on this Rust version and on some newer versions. All newer versions should also build, and if they do not, the issue should be reported and will be fixed. Older versions are not guaranteed to build and issues will not be fixed.

Build

make

Run Example

RUST_LOG=trace ./bin/aardvark-dns --config src/test/config/podman/ --port 5533 run

Configuration file format

Contributing