[GH-ISSUE #3472] Recursive Resolver - unknown variant 'Hint' #1188

New issue

Open

opened 2026-03-16 01:51:45 +03:00 by kerem · 3 comments

kerem commented

2026-03-16 01:51:45 +03:00

Owner

Originally created by @bcookatpcsd on GitHub (Feb 26, 2026).
Original GitHub issue: https://github.com/hickory-dns/hickory-dns/issues/3472

Assuming this will be a quick one.. as it seems to be a basic feature..

New user here.. read trhough the hickory-dns.org/book/ and thought I would give it a try..

Alpine linux package:

https://pkgs.alpinelinux.org/packages?name=hickory*&branch=edge&repo=&arch=x86_64&origin=&flagged=&maintainer=

Following this page:
https://hickory-dns.org/book/hickory/recursive_resolver.html

And trying to start with the created config and files:

[I] root@alpine-800g3 /e/hickory (master)# hickory-dns --port 2345 --debug --config=./config.toml
1772068271:INFO:hickory_dns:211:Hickory DNS 0.25.2 starting...
1772068271:INFO:hickory_dns:231:loading configuration from: "./config.toml"
Error: failed to read config file from "./config.toml": toml decode error: TOML parse error at line 2, column 1
  |
2 | [[zones]]
  | ^^^^^^^^^
unknown variant `Hint`, expected one of `Primary`, `Secondary`, `External`

https://gitlab.alpinelinux.org/alpine/aports/-/tree/master/community/hickory-dns?__goaway_challenge=cookie&__goaway_id=6e23f8eaef6579962d3944ceea19ea9e&__goaway_referer=https%3A%2F%2Fpkgs.alpinelinux.org%2F

The APKBUILD from 3months ago..

Is something missing from the build? or did the docs change?

I see others with issues about recursion..

So it must be me..

Thank you in advance.

Originally created by @bcookatpcsd on GitHub (Feb 26, 2026). Original GitHub issue: https://github.com/hickory-dns/hickory-dns/issues/3472 Assuming this will be a quick one.. as it seems to be a basic feature.. New user here.. read trhough the hickory-dns.org/book/ and thought I would give it a try.. Alpine linux package: https://pkgs.alpinelinux.org/packages?name=hickory*&branch=edge&repo=&arch=x86_64&origin=&flagged=&maintainer= Following this page: https://hickory-dns.org/book/hickory/recursive_resolver.html And trying to start with the created config and files: ``` [I] root@alpine-800g3 /e/hickory (master)# hickory-dns --port 2345 --debug --config=./config.toml 1772068271:INFO:hickory_dns:211:Hickory DNS 0.25.2 starting... 1772068271:INFO:hickory_dns:231:loading configuration from: "./config.toml" Error: failed to read config file from "./config.toml": toml decode error: TOML parse error at line 2, column 1 | 2 | [[zones]] | ^^^^^^^^^ unknown variant `Hint`, expected one of `Primary`, `Secondary`, `External` ``` https://gitlab.alpinelinux.org/alpine/aports/-/tree/master/community/hickory-dns?__goaway_challenge=cookie&__goaway_id=6e23f8eaef6579962d3944ceea19ea9e&__goaway_referer=https%3A%2F%2Fpkgs.alpinelinux.org%2F The APKBUILD from 3months ago.. Is something missing from the build? or did the docs change? I see others with issues about recursion.. So it must be me.. Thank you in advance.

kerem commented

2026-03-16 01:51:51 +03:00

Author

Owner

@djc commented on GitHub (Feb 27, 2026):

Can you share the config you're using? Usually these kinds of issues stem from a version mismatch between the source of the config and the code you're using.

@djc commented on GitHub (Feb 27, 2026): Can you share the config you're using? Usually these kinds of issues stem from a version mismatch between the source of the config and the code you're using.

kerem commented

2026-03-16 01:51:56 +03:00

Author

Owner

@cpu commented on GitHub (Feb 27, 2026):

I think the book content is out of date, and based on the error the OP is probably using this config.

@bcookatpcsd If you're using 0.25.2 and want a working recursive resolver config, try example_recursor.toml from the 0.25.2 tag (don't use what's in main - it likely won't be compatible with 0.25.2)

Maybe we should table the book until after the 0.26 release when we can get it synced up?

@cpu commented on GitHub (Feb 27, 2026): I think the book content is out of date, and based on the error the OP is probably using [this config](https://hickory-dns.org/book/hickory/recursive_resolver.html#configtoml). @bcookatpcsd If you're using 0.25.2 and want a working recursive resolver config, try [example_recursor.toml](https://github.com/hickory-dns/hickory-dns/blob/527c9f470a418cf6b92da902ea0aaa5749963d59/tests/test-data/test_configs/example_recursor.toml) from the 0.25.2 tag (don't use what's in `main` - it likely won't be compatible with 0.25.2) Maybe we should table the book until after the 0.26 release when we can get it synced up?

kerem commented

2026-03-16 01:52:01 +03:00

Author

Owner

@bcookatpcsd commented on GitHub (Feb 28, 2026):

Thank you

That looks to be the issue.

.. and my 0.02

Yes I didn't know what software version these directions went with..

assuming they were accurate at one time.

and was pretty sure this wasn't the time any longer.

Thank you for the response

@bcookatpcsd commented on GitHub (Feb 28, 2026): Thank you That looks to be the issue. .. and my 0.02 Yes I didn't know what software version these directions went with.. assuming they were accurate at one time. and was pretty sure this wasn't the time any longer. Thank you for the response ![image](https://github.com/user-attachments/assets/91ad2532-cc40-4411-a0d6-eb8c0e797b7d)