Step-by-step guide to configure Vivaldi to use our secure, token-gated DNS-over-HTTPS (DoH) service.
π· Vivaldi • Desktop β Verified • Working π DoH • Token AuthVivaldi includes built-in support for DNS-over-HTTPS (DoH) under the Network settings. This guide will help you configure Vivaldi to use our secure DNSaaS service with token-based authentication.
| Service | Endpoint | Authentication |
|---|---|---|
| Primary DNS | https://dns1.oss.co.za/xxxxx{?dns} |
Token in URL path |
| Protocol | DNS-over-HTTPS (DoH) • Port 443 • TLS 1.3 | |
| Vivaldi Version | Version 6.0+ (all recent versions) | |
{?dns} format (like Chrome).
Click the Vivaldi menu (red "V" icon in the top-left corner) β select Settings.
Alternatively, type vivaldi://settings/ in the address bar and press Enter.
In the left sidebar, scroll down and click Network.
Wrong: Going to Privacy & Security (this is for Chrome-like settings).
Correct: Go to Network in the left sidebar!
In the Network section, look for "DNS Over HTTPS".
Enable "Use a secure connection to look up site IP addresses".
Toggle "Enable DNS Lookup Over HTTPS" to ON.
Select "Custom DNS Provider" from the dropdown.
Enter the following URL (replace token_testclient123 with your token):
Correct: https://dns1.oss.co.za/testclient123{?dns}
Wrong: https://dns1.oss.co.za/testclient123?dns β Edge/Opera format
Wrong: https://dns1.oss.co.za/testclient123/dns-query β Firefox format
/token_testclient123{?dns} template variable/dns-query path neededThe setting saves automatically. Vivaldi will validate the endpoint.
adult.filterdns.net should show DNS_PROBE_FINISHED_NXDOMAIN.
Vivaldi's DNS settings are NOT under Privacy & Security!
They are under Network in the left sidebar.
Or simply type: vivaldi://settings/network in the address bar.
Use these test sites to verify your Vivaldi configuration is working correctly.
| Test Domain | Expected Result | What You Should See |
|---|---|---|
http://zycdjz.com |
BLOCKED | DNS_PROBE_FINISHED_NXDOMAIN |
http://malware.testcategory.com |
BLOCKED | DNS_PROBE_FINISHED_NXDOMAIN |
http://phishing.testcategory.com |
BLOCKED | DNS_PROBE_FINISHED_NXDOMAIN |
http://adult.filterdns.net |
BLOCKED | DNS_PROBE_FINISHED_NXDOMAIN |
| Test Domain | Expected Result | What You Should See |
|---|---|---|
https://example.com |
LOAD | Normal page loads |
https://google.com |
LOAD | Normal page loads |
| Test Domain | Expected Result | What You Should See |
|---|---|---|
https://dnsleaktest.com |
Your DNS Server | Should show dns1.oss.co.za or 102.220.218.218 |
| Browser | Endpoint Format | Example | Status |
|---|---|---|---|
| π· Vivaldi | {?dns} template |
https://dns1.oss.co.za/xxxxx{?dns} |
β Verified |
| π Chrome | {?dns} template |
https://dns1.oss.co.za/xxxxx{?dns} |
β Verified |
| π Edge | ?dns parameter |
https://dns1.oss.co.za/xxxxx?dns |
β Verified |
| π ΎοΈ Opera | ?dns parameter |
https://dns1.oss.co.za/xxxxx?dns |
β Verified |
| π¦ Firefox | /dns-query suffix |
https://dns1.oss.co.za/xxxxx/dns-query |
β Verified |
| π¦ Brave | ?dsn parameter |
https://dns1.oss.co.za/xxxxx?dsn |
β Verified |
{?dns} (curly braces)?dns/dns-query?dsnhttps://dns1.oss.co.za/xxxxx{?dns}{ }, not parentheses ( )vivaldi://settings/network directlyhttp://adult.filterdns.net - should show DNS_PROBE_FINISHED_NXDOMAINhttps://dnsleaktest.com - should show dns1.oss.co.zaTo revert to your previous DNS settings:
vivaldi://settings/network
Toggle "Enable DNS Lookup Over HTTPS" to OFF.
Visit vivaldi://net-internals/#dns and click "Clear host cache".
https://dns1.oss.co.za/xxxxx{?dns}{?dns} format (same as Chrome)