Template:Whonix-Gateway System DNS over Clearnet
Donate
Clearnet Whonix-Gateway System DNS.
Whonix-Gateway System DNS is required when using DNS hostnames. [1]
1 Apply the following changes to Whonix-Gateway™.
Open file /etc/resolv.conf.whonix in an editor with administrative ("root") rights.
1 Select your platform.
2 Notes.
- Sudoedit guidance: See
Open File with Root Rights
for details on why using sudoeditimproves security and how to use it. - Editor requirement: Close Featherpad (or the chosen text editor) before running the
sudoeditcommand.
3 Open the file with root rights.
sudoedit /etc/resolv.conf.whonix
2 Notes.
- Sudoedit guidance: See Open File with Root Rights for details on why using
sudoeditimproves security and how to use it. - Editor requirement: Close Featherpad (or the chosen text editor) before running the
sudoeditcommand. - Template requirement: When using Qubes-Whonix, this must be done inside the Template.
3 Open the file with root rights.
sudoedit /etc/resolv.conf.whonix
4 Notes.
- Shut down Template: After applying this change, shut down the Template.
- Restart App Qubes: All App Qubes based on the Template need to be restarted if they were already running.
- Qubes persistence: See also Qubes Persistence
- General procedure: This is a general procedure required for Qubes and is unspecific to Qubes-Whonix.
2 Notes.
- Example only: This is just an example. Other tools could achieve the same goal.
- Troubleshooting and alternatives: If this example does not work for you, or if you are not using Whonix, please refer to Open File with Root Rights.
3 Open the file with root rights.
sudoedit /etc/resolv.conf.whonix
2 Uncomment the line #nameserver 10.0.2.3.
Remove the hash ("#") before nameserver. This means you should change #nameserver 10.0.2.3 to nameserver 10.0.2.3.
3 Follow platform-specific steps:
- Non-Qubes-Whonix: Done.
- Qubes-Whonix™: This should typically work. If not, refer to the footnote. [2]
4 Done.
The configuration for Whonix-Gateway System DNS is complete.
5 Note for wiki editors.
Once Whonix 17.2.2.6 (Non-Qubes-WHonix) / 18.1.5.9 (Qubes-Whonix) or above is released, anon-dns
can be used and then the DNS enabling part can be simplified.
Footnotes
[edit]- ↑ Or Advanced Users would need to hardcode IP addressed rather than using hostnames.)
- ↑
Replace
10.0.2.3.- To identify the IP to substitute, execute the command below:
- qubesdb-read /qubes-netvm-primary-dns
- For example, the output might be:
10.139.1.1
- In this case, replace
10.0.2.3with10.139.1.1. Note: Use the actual IP from the output of thequbesdb-read /qubes-netvm-primary-dnscommand.
The most watertight privacy operating system in the world.
At
Whonix we value freedom and trust, supporting Open Source and Freedom Software
2012-
2026 ENCRYPTED SUPPORT LLC
We believe security software like Whonix needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 14 year success story and maybe DONATE!