dearsky/numa
1
0
Fork 0
Code Issues 10 Pull Requests 1 Actions Packages Projects Releases 25 Wiki Activity

docs(config): ODoH upstream examples with relay_ip/target_ip pinning #130

Merged
razvandimescu merged 1 commits from docs/numa-toml-odoh-examples into main 2026-04-22 22:20:19 +08:00
Conversation 0 Commits 1 Files Changed 1 +17
razvandimescu commented 2026-04-22 21:35:59 +08:00 (Migrated from github.com)
Copy Link

Summary

  • Adds a commented ODoH upstream block to numa.toml (mode, relay, target, strict, relay_ip, target_ip).
  • Documents relay_ip/target_ip as the way to keep the bootstrap resolver from leaking the relay/target hostnames on cold boot when numa is its own system DNS (see docs/implementation/bootstrap-resolver.md).

Complements #122 / #126.

Test plan

  • numa.toml parses cleanly (verified locally with python3 -c "import tomllib; tomllib.load(...)" — commented block is inert, file still valid TOML).
  • Uncommenting the ODoH block with the shipped relay+target values yields a working config (same shape as packaging/client/numa.toml in #131 — that end-to-end path is verified in #131's test plan).
## Summary - Adds a commented ODoH upstream block to `numa.toml` (mode, relay, target, strict, `relay_ip`, `target_ip`). - Documents `relay_ip`/`target_ip` as the way to keep the bootstrap resolver from leaking the relay/target hostnames on cold boot when numa is its own system DNS (see `docs/implementation/bootstrap-resolver.md`). Complements #122 / #126. ## Test plan - [x] `numa.toml` parses cleanly (verified locally with `python3 -c "import tomllib; tomllib.load(...)"` — commented block is inert, file still valid TOML). - [ ] Uncommenting the ODoH block with the shipped relay+target values yields a working config (same shape as `packaging/client/numa.toml` in #131 — that end-to-end path is verified in #131's test plan).
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Something isn't working
 dependencies
Pull requests that update a dependency file
 docker
Pull requests that update docker code
 documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 github_actions
Pull requests that update GitHub Actions code
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 question
Further information is requested
 rust
Pull requests that update rust code
 wontfix
This will not be worked on
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
dearsky
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: dearsky/numa#130
Delete Branch "docs/numa-toml-odoh-examples"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?