Common Whonix ™ CLI Commands

Introduction

There are a number of common command line operations that are performed by users of all skill levels in the Whonix ™ environment. This wiki page is intended to serve as a quick and handy reference guide for locating these, but it is not a substitute for reading relevant wiki entries that provide detailed instructions for various activities. Additional, useful commands will be added here over time.

Whonix-Gateway

Table: Whonix-Gateway ™ Common Commands

Category	Commands
Change Keyboard Layout	sudo dpkg-reconfigure keyboard-configuration sudo dpkg-reconfigure keyboard-configuration sudo dpkg-reconfigure console-data sudo dpkg-reconfigure console-data
Circumvent uwt Wrapper Use	/usr/bin/apt-get.anondist-orig /usr/bin/wget.anondist-orig /usr/bin/curl.anondist-orig /usr/bin/gpg.anondist-orig /usr/bin/ssh.anondist-orig
Connection Wizard (Enable/Disable Tor)	lxsudo anon-connection-wizard lxsudo anon-connection-wizard sudo whonixsetup sudo whonixsetup
Default Username and Password	Default username: user Default password: changeme
Important Configuration Files / Folders	Important configuration files: nano /usr/local/etc/torrc.d/50_user.conf nano /usr/local/etc/torrc.d/50_user.conf nano /etc/whonix_firewall.d/50_user.conf nano /etc/whonix_firewall.d/50_user.conf Important configuration folders: /etc/whonix.d/ /etc/whonix_firewall.d/
Important Logs	tail -f /var/log/syslog tail -f /var/log/syslog tail -f -n 20 /var/log/sdwdate.log tail -f -n 20 /var/log/sdwdate.log tail -f /var/log/controlportfilt.log tail -f /var/log/controlportfilt.log tail -f /var/log/tor/log tail -f /var/log/tor/log
Nyx: Tor Command Line Monitor	Launch Nyx: nyx nyx
OS Updates	sudo apt-get update && sudo apt-get dist-upgrade sudo apt-get update && sudo apt-get dist-upgrade or sudo apt-get-update-plus dist-upgrade sudo apt-get-update-plus dist-upgrade
Switch to Clearnet User	sudo su clearnet sudo su clearnet
sdwdate	Restart sdwdate: sudo /usr/lib/sdwdate/restart_fresh sudo /usr/lib/sdwdate/restart_fresh
Time	Report the date in UTC: date -u date -u Manually set the system clock: sudo date -s "17 FEB 2019 24:00:00" && sudo hwclock -w sudo date -s "17 FEB 2019 24:00:00" && sudo hwclock -w Randomize the time: clock-random-manual-gui: a randomized clock setting (in UTC) is entered via a GUI. clock-random-manual-cli: a randomized clock setting (in UTC) is entered on the command line. For example: echo "Wed Dec 04 06:20:13 UTC 2019" | /usr/bin/clock-random-manual-cli echo "Wed Dec 04 06:20:13 UTC 2019" | /usr/bin/clock-random-manual-cli
Tor	Restart Network: sudo service networking restart sudo service networking restart Restart Tor: sudo service tor restart sudo service tor restart Stop Tor: sudo systemctl stop tor@default sudo systemctl stop tor@default Check the Tor version: anon-info anon-info Check the Tor configuration: anon-verify anon-verify sudo -u debian-tor tor --verify-config sudo -u debian-tor tor --verify-config
Virtual Consoles	Text console: Press Alt + Crtl + F1 Additional text consoles: Press Alt + Crtl + F2 or F3 and so on. Graphical console: Press Alt + Crtl + F7
VM Operations	Reboot: sudo reboot sudo reboot Power off: sudo poweroff sudo poweroff
whonixcheck	Network Time Synchronization and Tor Connection Check: whonixcheck whonixcheck
Whonix Version	Whonix version: cat /etc/whonix_version cat /etc/whonix_version

Whonix-Workstation

Table: Whonix-Workstation ™ Common Commands

Category	Commands
Change Keyboard Layout	sudo dpkg-reconfigure keyboard-configuration sudo dpkg-reconfigure keyboard-configuration sudo dpkg-reconfigure console-data sudo dpkg-reconfigure console-data
Circumvent uwt Wrapper Use	/usr/bin/apt-get.anondist-orig /usr/bin/wget.anondist-orig /usr/bin/curl.anondist-orig /usr/bin/gpg.anondist-orig /usr/bin/git.anondist-orig /usr/bin/ssh.anondist-orig
Default Username and Password	Default username: user Default password: changeme
DNS Resolution Functionality Test	nslookup check.torproject.org nslookup check.torproject.org
GnuPG (OpenPGP)	Retrieve keys (example): Display key fingerprint (example): sudo apt-key adv --fingerprint A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 sudo apt-key adv --fingerprint A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 Check file signatures (example): gpg --verify tor-browser-linux64-8.5_en-US.tar.xz.asc tor-browser-linux64-8.5_en-US.tar.xz gpg --verify tor-browser-linux64-8.5_en-US.tar.xz.asc tor-browser-linux64-8.5_en-US.tar.xz
HexChat	Reset HexChat identity: hexchat-reset hexchat-reset
Important Configuration Folders and Logs	Important configuration folders: /etc/whonix.d/ /etc/whonix_firewall.d/ Important logs: tail -f /var/log/syslog tail -f /var/log/syslog tail -f -n 20 /var/log/sdwdate.log tail -f -n 20 /var/log/sdwdate.log
Leak Test	leaktest leaktest
Network Restart	sudo service networking restart sudo service networking restart
OS Updates / Software Installation	sudo apt-get update && sudo apt-get dist-upgrade sudo apt-get update && sudo apt-get dist-upgrade or sudo apt-get-update-plus dist-upgrade sudo apt-get-update-plus dist-upgrade Install the package-name package. sudo apt-get install package-name sudo apt-get install package-name Install the package-name package from Debian backports. sudo apt-get -t buster-backports install package-name sudo apt-get -t buster-backports install package-name
Time	Manually set the system clock: sudo date -s "17 FEB 2019 24:00:00" && sudo hwclock -w sudo date -s "17 FEB 2019 24:00:00" && sudo hwclock -w
Tor Browser	Important folders: ~/.tb/tor-browser ~/.tb/tor-browser/Browser/TorBrowser/Data/Browser Tor Browser Launcher: torbrowser torbrowser Tor Browser in debugging mode: ~/.tb/tor-browser/Browser/start-tor-browser --debug ~/.tb/tor-browser/Browser/start-tor-browser --debug Tor Browser Updater: update-torbrowser update-torbrowser
Virtual Consoles	Text console: Press Alt + Crtl + F1 Additional text consoles: Press Alt + Crtl + F2 or F3 and so on. Graphical console: Press Alt + Crtl + F7
VM Operations	Reboot: sudo reboot sudo reboot Power off: sudo poweroff sudo poweroff
whonixcheck	Network Time Synchronization and Tor Connection Check: whonixcheck whonixcheck
Whonix Version	Whonix version: cat /etc/whonix_version cat /etc/whonix_version

Footnotes

---

Whonix ™ is Supported by Evolution Host DDoS Protected VPS. Stay private and get your VPS with Bitcoin or Monero.

---

Follow:

Donate:

Share: Twitter | Facebook

Did you know that Whonix could provide protection against backdoors ^[archive]? See Verifiable Builds ^[archive]. Help is wanted and welcomed.

This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! Read, understand and agree to Conditions for Contributions to Whonix ™, then Edit! Edits are held for moderation.

Copyright (C) 2012 - 2019 ENCRYPTED SUPPORT LP. Whonix ™ is a trademark. Whonix ™ is a licensee ^[archive] of the Open Invention Network ^[archive]. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Freedom Software license as Whonix ™ itself. (Why?)

Whonix ™ is a derivative of and not affiliated with Debian ^[archive]. Debian is a registered trademark ^[archive] owned by Software in the Public Interest, Inc ^[archive].

Whonix ™ is produced independently from the Tor® ^[archive] anonymity software and carries no guarantee from The Tor Project ^[archive] about quality, suitability or anything else.

By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent. Whonix ™ is provided by ENCRYPTED SUPPORT LP. See Imprint.