Website

This website is built using Docusaurus 2, a modern static website generator.

master branch is published automatically to https://kb-dns.pages.dev/.

How to contribute

You can help by contributing to the Knowledge Base, all details are in this article.

How to develop

Prepare

First of all, you need to install the following:

• git
• pnpm

• git clone [email protected]:AdguardTeam/KnowledgeBaseDNS.git

Then you should open Terminal on your computer and navigate to the directory where you cloned this repo and run this command to install the local dependencies:

[!NOTE]

For version 11 and above of pnpm, you may need to use pnpm approve-builds.

• pnpm install

Lint markdown

This command lints the markdown and outputs any errors to the console:

• pnpm lint:md

• pnpm lint:md --fix

Run it locally

• pnpm start

How to build

• pnpm build

How to translate

Translations are not pushed to the repo and prepared on-the-fly (i18n folder is added to .gitignore).

Here’s how you can debug translations locally.

1. Download translations: CROWDIN_PERSONAL_TOKEN="YOURTOKEN" pnpm run crowdin download
2. Run Docusaurus with the language of your choice: pnpm run start -- --locale de

How to generate DNS stamps

If you’d like to update the list of known DNS Providers, you’ll need to know how to create and check DNS stamps. Read the brief tutorial below to learn how to do it.

For DNS-over-HTTPS

1. Go to Online DNS Stamp calculator
2. Choose DNS-over-HTTPS from the drop-down menu
3. Fill out the Host name and Path fields of the form
4. Copy the ready DNS stamp from the Stamp field

For DNS-over-TLS

1. Go to Online DNS Stamp calculator
2. Choose DNS-over-TLS from the drop-down menu
3. Fill out the Host name field
4. Copy the ready DNS stamp from the Stamp field

For DNS-over-QUIC

1. Go to Online DNS Stamp calculator
2. Choose DNS-over-QUIC from the drop-down menu
3. Fill out the Host name field
4. Copy the ready DNS stamp from the Stamp field

For Plain DNS

1. Go to Online DNS Stamp calculator
2. Choose Plain DNS from the drop-down menu
3. Fill out the IP address field
4. Copy the ready DNS stamp from the Stamp field

How to check DNS stamps

1. Install dnslookup using Homebrew or from source
2. Run a command. Examples of commands for different protocols are given on this page