nlnetlabs / unbound-manual

The Official Unbound User Manual

unbound-manual

The Official Unbound User Manual, published at unbound.docs.nlnetlabs.nl

Style Guide

This manual uses British English. Since there is quite a bit of leeway in English style, we use the European Commission’s English Style Guide as guidance.

unbound-manual's Issues

Excluding Specific Networks from EDNS Client Subnet Requests

Instead of selecting the network to which I want to send the EDNS with send-client-subnet, I would like to have an option to exclude certain networks, such as 100.64.0.0/10. When I send this network, I receive a response that does not match the expected location. Is it possible to configure this, or do I have to explicitly define the networks that should be sent?

Need updated build instructions for 1.17.1 & 1.18.0

This issue might be related to building on a 64 bit "lite" version of Pi OS and a server version of Ubuntu 23.04. Its a problem with the python version detection in ./configure and there seems to be a change between 1.17.1 and 1.18.0.

I think I had to install libpython3.9-dev to get ./configure to finish on the pi OS lite with 1.17.1 then I had to install python3-distutils for ./configure to finish on 1.18.0.

For the server version of ubuntu 23.04 they upgraded to python 3.11 so I had to install libpython3.11-dev but never got ./configure to finish. I forgot that I ended up using the prebuilt version 1.17.1 of Unbound that was installed by Ubuntu 23.04.

I think there are a few other build tools that needed to be installed that aren't listed in the manual. I'm not sure if it's because I'm using lite and server versions, but it would be nice to have a full list of tools needed to be installed in the manual instead of having to search for what to install when you get a make error. I feel like the old documentation that was at https://nlnetlabs.nl/documentation/unbound/ used to have a more detailed list of tools needed back in Unbound 1.13.1 but I could be wrong.

BTW, I think I was able to run ./configure on 1.17.0 w/o errors before trying 1.17.1.

New use case for combining Unbound with auth servers/data

This could be under "Use Cases" and list options on how to serve (or point to) authoritative data when Unbound listens on port 53.

issue with local-stub (homebrew) documentation

Describe the bug
The documentation here mentions the following:

Homebrew[¶](https://unbound.docs.nlnetlabs.nl/en/latest/use-cases/local-stub.html#homebrew)
If you installed Unbound using Homebrew, the XML file required by launchctl is already supplied during installation. The file can be found at /Library/LaunchDaemons/homebrew.mxcl.unbound.plist. To load this file we invoke the following command.

sudo launchctl load /Library/LaunchDaemons/homebrew.mxcl.unbound.plist

Now every time you restart your machine, Unbound should restart too.

However this file doesn't exist. In my case it was here:

/opt/homebrew/Cellar/unbound/1.20.0/homebrew.mxcl.unbound.plist

I copied it over to /Library/LaunchDaemons and then performed the command as per the docs. That succeeded.

Automatic typo check

Maybe this can be part of actions.
Inspiration from #30

Not able to choose the version on the documentation site

Describe the bug
https://unbound.docs.nlnetlabs.nl/en/latest/ - when I click "v: latest" on the bottom left part (and "read the docs" too), nothing happens (but the cursor indicates that it should be clickable).

Expected behavior
I expected to be able to choose the needed version (or at least to see that only 'latest' is available in the dropdown).

Additional information
Tested in Firefox, Chrome.
In the console I see the following, it could be related:

latest/:442 Uncaught ReferenceError: jQuery is not defined
    at latest/:442:7

Options should be complemented by "introduced in version" information

The latest build should somehow point to the actual version

Like 1.19.0+ for updated documents in the 1.19.0 release.

Refresh server selection page

Check for correctness, add missing information (e.g., how to influence server selection) and relocate out of the History section