This repo hosts strings used by the DNS Over HTTPS doorhanger UI shipping in Firefox.

This is a temporary setup until the strings are migrated to conform to standard mozilla-central protocol.

---

Former README below for archival purposes

Note - This repository has been archived as of Tuesday, January 7th, 2020. The DNS-over-HTTPS extension has been migrated to the Firefox browser as of Release 72. Please file any issues regarding this extension through Bugzilla.

DoH Rollout

This is a WebExtension + Experimental API to gradually roll out DNS-over-HTTP to Firefox users.

How to install WebExtension

1. Install web-ext npm install -g web-ext
2. Install the dependencies npm install
3. Build the addon npm run build

How to run WebExtension

1. web-ext run --verbose -f Nightly

OR

1. Run a non-release build (Nightly or Aurora) version 61+.
2. Set extensions.legacy.enabled to true in about:config
3. Navigate to about:debugging, choose "Load Temporary Add-on" and select a file from this project:
   • Select manifest.json
   • Select src/web-ext-artifacts/dns_over_https-${VERSION}.zip

You should see a new entry in the list of extensions titled "DoH Rollout".

To see the banner create a new boolean pref doh-rollout.enabled in about:config and set to true.

This will run heuristics against your network settings to determine if DoH can safely be enabled. If it can, it will trigger a doorhanger notification announcing that is has been enabled.

To check if DoH is turned on, check the value of pref network.trr.mode. If it is enabled, it will be set to 2.

Telemetry will be sent each time heuristics are evaluated.

Dependencies

• web-ext
• Firefox 61+

Contributing

See the guidelines for contributing to this project – including on how best to report an issue with this project.

This project is governed by a Code Of Conduct.

To disclose potential a security vulnerability please see our security documentation.

License

This module is licensed under the Mozilla Public License, version 2.0.

Press Releases

Related press releases:

• What’s next in making Encrypted DNS-over-HTTPS the Default September 9, 2019
• DNS-over-HTTPS (DoH) Update – Detecting Managed Networks and User Choice July 31, 2019
• DNS-over-HTTPS (DoH) Update – Recent Testing Results and Next Steps April 2, 2019
• Next Steps in DNS-over-HTTPS Testing November 11, 2018
• DNS over HTTPS (DoH) – Testing on Beta September 13, 2018