Skip to content

feat(adguard-home): add certificate selection support for DoT/DoH TLS configuration#5076

Open
lohart13 wants to merge 2 commits into
truenas:masterfrom
lohart13:adguard-home-certs
Open

feat(adguard-home): add certificate selection support for DoT/DoH TLS configuration#5076
lohart13 wants to merge 2 commits into
truenas:masterfrom
lohart13:adguard-home-certs

Conversation

@lohart13

@lohart13 lohart13 commented Jun 2, 2026

Copy link
Copy Markdown

Summary

This PR adds support for selecting a TrueNAS certificate for AdGuard Home so it can be used for DNS-over-TLS and DNS-over-HTTPS configuration inside the container.

Changes

  • Added network.certificate_id to questions.yaml
  • Injects selected certificate and private key into the container when provided:
    • /opt/adguardhome/ssl/server.crt
    • /opt/adguardhome/ssl/server.key
  • Added TLS usage notes to ix_values.yaml notes body
  • Added certificates-values.yaml test values file
  • Bumped app version in app.yaml from 1.3.11 to 1.3.12

Notes

This change does not force portal scheme changes; it only makes cert/key material available for AdGuard Home encryption settings.

Copilot AI review requested due to automatic review settings June 2, 2026 21:56

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds support for selecting a TrueNAS certificate and injecting it into the AdGuard Home container for configuring DNS-over-TLS / DNS-over-HTTPS.

Changes:

  • Add a certificate_id question to select a TrueNAS certificate.
  • Template docker-compose generation to mount selected certificate + private key into the container.
  • Add test values fixture covering certificate selection and bump chart/app version.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
ix-dev/community/adguard-home/templates/test_values/certificates-values.yaml Adds a test fixture with certificate_id and embedded PEM materials.
ix-dev/community/adguard-home/templates/docker-compose.yaml Mounts selected cert and key into container paths when certificate_id is set.
ix-dev/community/adguard-home/questions.yaml Exposes certificate selection in the app questions UI.
ix-dev/community/adguard-home/ix_values.yaml Adds TLS file path constants and user-facing notes about where files are mounted.
ix-dev/community/adguard-home/app.yaml Bumps app/chart version.

Comment thread ix-dev/community/adguard-home/templates/docker-compose.yaml
@lohart13 lohart13 force-pushed the adguard-home-certs branch from fb17c1e to bfb9e61 Compare June 4, 2026 08:18
Comment on lines +16 to +23
## TLS / DNS-over-TLS / DNS-over-HTTPS

If you selected a certificate, it will be available inside the container at:
- Certificate: /opt/adguardhome/ssl/server.crt
- Private Key: /opt/adguardhome/ssl/server.key

Configure AdGuard Home to use these paths in the AdGuard Home web UI
under Settings > Encryption Settings.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesnt Adguard provide cli flags or env vars to set this up?
I'm not a fan of mounting the files but still have the user do extra steps to configure it.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@stavros-k from what I have seen, it is not possible to set these values via CLI flags or ENV vars. Based on my knowledge, you need to either edit the YAML or set these values via the UI.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yea that's unfortunate.

Certificate dropdown is meant to be used when we can actually configure the app to use it automatically.
I'm not sure I want to expose it in this case.

Copilot AI and others added 2 commits June 6, 2026 08:19
… configuration

## Summary
This PR adds support for selecting a TrueNAS certificate for AdGuard Home so it can be used for DNS-over-TLS and DNS-over-HTTPS configuration inside the container.

## Changes
- Added `network.certificate_id` to `questions.yaml`
- Injects selected certificate and private key into the container when provided:
  - `/opt/adguardhome/ssl/server.crt`
  - `/opt/adguardhome/ssl/server.key`
- Added TLS usage notes to `ix_values.yaml` notes body
- Added `certificates-values.yaml` test values file
- Bumped app version in `app.yaml` from `1.3.11` to `1.3.12`

## Notes
This change does not force portal scheme changes; it only makes cert/key material available for AdGuard Home encryption settings.
@lohart13 lohart13 force-pushed the adguard-home-certs branch from bfb9e61 to 1788ea0 Compare June 6, 2026 08:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants