Stubby configuration with /etc/config/stubby or /etc/stubby/stubby.yml

Sindbad6 · December 25, 2025, 7:35pm

Hi,

I installed stubby for DoT and configured it in /etc/config/stubby. Now I recognize, that there is also a /etc/stubby/stubby/stubby.yml file. In both seems to be the same settings made. My question is, which one of this files is the relevant one?

brada4 · December 25, 2025, 7:43pm

If you set uci stubby.global.manual to != 0 yaml is used, in default config yaml is generated from /etc/config.

Sindbad6 · December 25, 2025, 8:24pm

If I understand it right in default, the configurations should be the same. In my case at a minimum the configured DNS servers are different.

If I understand it correctly, with the command below /etc/stubby/stubby.yml should be generated from the /etc/config/stubby file. How I can initiate this?

uci set stubby.global.manual='1'

brada4 · December 25, 2025, 8:50pm

Yep, followed by uci commit stubby and service stubby reload
yaml example here

github.com/getdnsapi/stubby

stubby.yml.example

develop

################################################################################
######################## STUBBY YAML CONFIG FILE ###############################
################################################################################
# This is a yaml version of the stubby configuration file (it replaces the
# json based stubby.conf file used in earlier versions of getdns/stubby).
#
# For more information see
# https://dnsprivacy.org/wiki/display/DP/Configuring+Stubby
#
# This format does not fully support all yaml features - the restrictions are:
#   - the outer-most data structure must be a yaml mapping
#   - mapping keys must be yaml scalars
#   - plain scalars will be converted to json unchanged
#   - non-plain scalars (quoted, double-quoted, wrapped) will be interpreted
#     as json strings, i.e. double quoted.
#   - yaml tags are not supported
#   - IPv6 addresses ending in :: are not yet supported (use ::0)
#
# Also beware that yaml is sensitive to the indentation at the start of each
# line so if you encounter errors when parsing the config file then please check

This file has been truncated. show original

(it is referenced in uci file of newer stubby packages)

Sindbad6 · December 25, 2025, 9:07pm

Thanks for your support. Unfortunately, after execution of the uci commands the stubby.yml is still unchanged. Any idea why?

brada4 · December 25, 2025, 9:14pm

Default is to generate stubby.yml somewhere in /tmp
If you set it to manual you have full config file in /etc/stubby and you have to edit that, ie one of configuraations is ignored at any given time.

Sindbad6 · December 25, 2025, 9:18pm

Okay, and what I have to do, to set up the valid configuration in /etc/config/stubby and to transmit it to the stubby.yml file?

brada4 · December 25, 2025, 9:21pm

ps w | grep stubby
10088 stubby    8564 S    /usr/sbin/stubby -C /var/etc/stubby/stubby.yml

copy that file to /etc/

cat  /var/etc/stubby/stubby.yml > /etc/stubby/stubby.yml

Sindbad6 · December 25, 2025, 9:32pm

Thanks, that worked.

system · January 4, 2026, 9:32pm

This topic was automatically closed 10 days after the last reply. New replies are no longer allowed.