πŸ”· Configure Vivaldi for Secure DNSaaS

Step-by-step guide to configure Vivaldi to use our secure, token-gated DNS-over-HTTPS (DoH) service.

πŸ”· Vivaldi • Desktop βœ… Verified • Working πŸ”’ DoH • Token Auth

πŸ“‹ Overview

Vivaldi 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)
πŸ’‘ Vivaldi DNS Settings Location Important: Vivaldi's DNS settings are in Network, NOT in Privacy & Security! Vivaldi uses the {?dns} format (like Chrome).

πŸ”· Configure Vivaldi Step-by-Step

1 Open Vivaldi Settings

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.

πŸ’‘ Tip The Vivaldi menu is the red "V" in the top-left corner of the browser window.

2 Navigate to Network

In the left sidebar, scroll down and click Network.

⚠️ Common Mistake

Wrong: Going to Privacy & Security (this is for Chrome-like settings).

Correct: Go to Network in the left sidebar!

3 Find "DNS Over HTTPS"

In the Network section, look for "DNS Over HTTPS".

Enable "Use a secure connection to look up site IP addresses".

4 Enable DNS Lookup Over HTTPS

Toggle "Enable DNS Lookup Over HTTPS" to ON.

Select "Custom DNS Provider" from the dropdown.

5 Enter the Custom DoH Endpoint

Enter the following URL (replace token_testclient123 with your token):

https://dns1.oss.co.za/testclient123{?dns}
⚠️ Important: Vivaldi uses {?dns}

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

βœ… Vivaldi Format
  • The token is in the URL path: /token_testclient123
  • Vivaldi uses the {?dns} template variable
  • No /dns-query path needed
  • Same format as Google Chrome

6 Save and Verify

The setting saves automatically. Vivaldi will validate the endpoint.

βœ… Success Indicator Blocked domains like adult.filterdns.net should show DNS_PROBE_FINISHED_NXDOMAIN.

πŸ—ΊοΈ Quick Navigation Reference

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.

πŸ§ͺ Test Your Configuration

Use these test sites to verify your Vivaldi configuration is working correctly.

Blocked Domains (Should NOT Load)

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

Clean Domains (Should Load Normally)

Test Domain Expected Result What You Should See
https://example.com LOAD Normal page loads
https://google.com LOAD Normal page loads

DNS Leak Test

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 Formats Comparison

πŸ”· Vivaldi {?dns} βœ… Working
🌐 Chrome {?dns} βœ… Working
🌐 Edge ?dns βœ… Working
πŸ…ΎοΈ Opera ?dns βœ… Working
🦊 Firefox /dns-query βœ… Working
🦁 Brave ?dsn βœ… Working
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
⚠️ Important
  • Vivaldi and Chrome use {?dns} (curly braces)
  • Edge and Opera use ?dns
  • Firefox uses /dns-query
  • Brave uses ?dsn

πŸ”§ Troubleshooting

❌ "Please verify that this is a valid provider"
  • Make sure you're using the correct format: https://dns1.oss.co.za/xxxxx{?dns}
  • Use curly braces { }, not parentheses ( )
  • Check that your token is valid and active
❌ Can't find DNS settings
  • Make sure you're in Network section (left sidebar)
  • NOT Privacy & Security
  • Or type vivaldi://settings/network directly
βœ… Verify It's Working
  • Visit http://adult.filterdns.net - should show DNS_PROBE_FINISHED_NXDOMAIN
  • Visit https://dnsleaktest.com - should show dns1.oss.co.za

↩️ How to Roll Back

To revert to your previous DNS settings:

Step 1: Go to Network

vivaldi://settings/network

Step 2: Turn Off DNS Over HTTPS

Toggle "Enable DNS Lookup Over HTTPS" to OFF.

Step 3: Clear DNS Cache

Visit vivaldi://net-internals/#dns and click "Clear host cache".

🎯 Summary


πŸš€ Quick Reference:
https://dns1.oss.co.za/testclient123{?dns}

🌐 Browser Format Comparison:
Vivaldi: https://dns1.oss.co.za/xxxxx{?dns}
Chrome: https://dns1.oss.co.za/xxxxx{?dns}
Edge: https://dns1.oss.co.za/xxxxx?dns
Opera: https://dns1.oss.co.za/xxxxx?dns
Firefox: https://dns1.oss.co.za/xxxxx/dns-query
Brave: https://dns1.oss.co.za/xxxxx?dsn