Instant Messenger Chat
- 1 General Safety Advice
- 2 Recommendation
- 3 Gajim
- 4 HexChat: IRC Client
- 5 Ricochet IM
- 6 Tox
- 7 Deprecated Chat Clients
- 8 Other Software
- 9 Footnotes / References
- 10 License
General Safety Advice
Tip: Most existing instant messenger protocols are unsafe from a privacy point of view. This is not a Whonix-specific problem, but a general problem with instant messengers.
It is estimated that within 10 to 15 years, Quantum Computers will break today's common asymmetric public-key cryptography algorithms used for web encryption (https), e-mail encryption (GnuPG...), SSH and other purposes. See Post-Quantum Cryptography (PQCrypto).
Tor exit relays can eavesdrop on communications if encryption to the server is disabled. Depending on the protocol, encryption might be disabled by default or not even supported. Tails has noted that without encryption, the exit relay can see the contact list, all messages, file transfers, and audio/video.  While encryption to the server prevents exit relay eavesdropping, it still leaves one problem unresolved: server logging.
Encrypted server connections do not prevent the server gathering interesting information about users, such as common contacts and the regularity of communications. An example list includes:
- Account names.
- Buddy list (list of contacts).
- The exact date and time of logins.
- Message timestamps.
- Communication patterns like common contacts.
- If the recipient knows the sender and has ever used a non-anonymous account or logged in without Tor, this information can be used to try and determine the sender's identity.
The content of messages will only be protected by using end-to-end encryption, for example Off-the-Record (OTR) encryption. To completely remove the threat of server logging, prefer decentralized (server-less) instant messengers like Ricochet IM.
Jabber / XMPP
Jabber/XMPP is a free server-federation-based protocol designed with openness in mind: "... All of the existing XMPP servers, clients, and programming libraries support the key features of an IM system, such as one-to-one and multi-party messaging, presence subscriptions and notifications, and contact lists."
The system is decentralized because there is no central authoritative server; anyone can run a server. Some users are confused on this point because there are a number of large and popular public XMPP servers (like jabber.org), to which many have subscribed.  Each network user has a unique XMPP address called a JID (Jabber ID). The JID is similar to an email address insofar as it has a username and domain name like email@example.com 
Safely using the protocol requires proper use of OTR, because it is unwise to trust server connections are properly encrypted between each other. Jabber privacy is also limited, as various adversaries are capable of observing which accounts are communicating. Jabber and Tor combined only guarantee pseudonymous communications, as while the user's current location is hidden, the social graph can still expose their true identity. For tips on operational security when chatting anonymously, see this article by The Intercept. Also see: Why prefer open protocols such as Jabber/XMPP over proprietary ones such as ICQ?
When using IRC inside Whonix-Workstation, the Ident Protocol is automatically blocked because Whonix-Workstation is firewalled. Therefore the associated daemon will not identify the username which is linked with a particular TCP connection, as is normally the case.
The Tor Project Internet Relay Chat page contains a number of important recommendations and tips for safe IRC use:
- Use onion services when available.
- Check self-signed certificates have the correct SSL/TLS certificate.
- Cycle Tor circuits to evade censorship bans.
- Chain VPNs and Tor for registration.
- Use OTR for end-to-end encryption.
- Distrust users and servers in general.
- Avoid personally identifiable information in chats.
- Check the user fingerprint before using IRC.
- Harden the IRC client.
- And more.
Applications discussed in this chapter are listed in order of best usability and compatibility with Whonix, based on the opinion and experience of Whonix developers.
It should be noted that no single application listed here has a superior feature set. Users must make a choice based on personal preferences and their self-assessed threat model:
- Gajim has better usability, more Jabber users, supports offline messages, and can provide OTR or OMEMO-grade encryption. On the downside, it requires a Jabber server which weakens anonymity.
- HexChat is an open source IRC client based on XChat (therefore not technically an instant messenger). It has better usability and supports encrypted plugins like OTR, but on the downside it relies on centralized IRC servers.
- Ricochet IM is a decentralized (server-less) option, but it "only" uses onion encryption and is difficult to set up. OTR or OMEMO-grade encryption is not yet available,  and offline messages are not supported.  Ricochet IM is also not user-friendly.
- Tox is also a fully-featured, decentralized (server-less) option which employs strong encryption, but the software is in alpha status and is not available as a Debian package.  Tox developers warn in their wiki: "... Keep in mind that these clients are alpha software under heavy development, and are probably not ready for day-to-day use. ..." 
Ubuntu provides a succinct overview of Gajim: 
Gajim is a free software, instant messaging client for the Jabber (XMPP) protocol which uses the GTK+ toolkit. It runs on GNU/Linux, BSD and Windows. The name Gajim is a recursive acronym for Gajim (is) a jabber instant messenger. The goal of Gajim is to provide a full featured and easy to use Jabber client. Gajim works nicely with GNOME, but does not require it to run. It is released under the GNU General Public License.
Gajim has various features, including: 
- Chat client synchronization.
- Group chats.
- Sending of pictures, videos and other files to friends or groups.
- Secure end-to-end encryption via OMEMO or PGP.
- The option to keep and manage all chat history.
- Connection compatibility with other messengers via transports, such as IRC.
- Various other features are available via plugins.
In late-2018, audio/video is reportedly not functional in Gajim. Further, OTR support was dropped in Gajim release 1.0, but the OMEMO plugin is an encryption alternative.  Note that Debian stretch has v0.16 of the Gajim package available, so optionally the OTR plugin can still be used instead of OMEMO (stretch-backports has v1.1 available).
Tip: Gajim dependencies and Debian instructions are always available here.
The steps below install Gajim, along with the OMEMO encryption plugin and HTTP Upload plugin (which is required for file transfers).  The latter plugin is fully integrated into the core Gajim software as of v1.0. Upon first launch of the program, users can use an existing XMPP account or create a new one.
Update the package lists.
sudo apt-get update
Install gajim, gajim-omemo and gajim-httpupload.
sudo apt-get install gajim gajim-omemo gajim-httpupload
Start Gajim from the start menu or type in konsole.
On first launch, an Account Creation Wizard Dialog will appear. Use the wizard to either create a new account to connect to the jabber network or use an existing account. For new accounts, there are multiple jabber servers available and only a username and password is required to join. 
The following changes are recommended for better security and privacy.
Save conversation logs for all contacts
Not available after
Allow client / OS information to be sent
Allow local system time information to be sent
Log encrypted chat session
Allow my idle time to be sent
Custom-> clear fields for: 
Network settings: 
Use proxy authentication-> set
Gajim cannot be installed by default in Whonix yet, as there is more development work TODO; see Dev/Gajim.
HexChat: IRC Client
Ricochet IM is is a portable, P2P, python chat application that is installed in Whonix by default. It is the new successor to the unmaintained TorChat.  The Ricochet site describes how the application works: 
Ricochet uses the Tor network to reach your contacts without relying on messaging servers. It creates a hidden service, which is used to rendezvous with your contacts without revealing your location or IP address.
Instead of a username, you get a unique address that looks like ricochet:rs7ce36jsj24ogfw. Other Ricochet users can use this address to send a contact request - asking to be added to your contacts list.
You can see when your contacts are online, and send them messages (and soon, files!). Your list of contacts is only known to your computer - never exposed to servers or network traffic monitoring.
Everything is encrypted end-to-end, so only the intended recipient can decrypt it, and anonymized, so nobody knows where it’s going and where it came from.
In summary, the benefits of Ricochet IM include:
- No saving of chat history.
- Reliance on Tor onion services for identity creation.
- Encryption and authentication properties therefore match Tor's strength.
- The server-less design means no metadata is ever collected.
- An OTF sponsored audit in early 2016 only identified a few minor problems (since fixed).  
Ricochet should be fully functional in Whonix. If any problems are encountered, please leave comments on the open Phabricator ticket.
Add a Ricochet Python Profile
In Whonix-Gateway (
sys-whonix), onion-grater requires some adjustments.
Extend onion-grater Whitelist
Modify Firewall Settings
In Whonix-Workstation (
anon-whonix), the firewall requires some adjustments.
Modify Whonix-Workstation User Firewall Settings
Reload Whonix-Workstation Firewall.
In Whonix-Workstation (
anon-whonix), launch ricochet either through the start menu or from the command line.
Tox   looks like a promising solution for secure, encrypted communications. The official client implementation is based on the Toxcore protocol library, which is very feature-rich and has a variety of functions besides VoIP. By default, Tox does not attempt to cloak your IP address from authorized contacts. However, Tox connections can be tunneled through Tor, allowing communication with others even if they are not anonymous.  Desktop and mobile client versions have been developed for every major OS platform. 
In the Tox design, users are assigned a public and private key, with direct connections being established in a peer-to-peer network. Users can message friends, join chat rooms with friends or strangers, and send each other files. Everything is encrypted using the NaCl crypto library, via libsodium.   Tox helps to protect user privacy by: 
- Removing the need to rely on central authorities to provide messenger services
- Enforcing end-to-end encryption with perfect forward secrecy as the default and only mode of operation for all messages
- Making your identity impossible to forge without the possession of your personal private key, which never leaves your computer
- Voice and video calls.
- Instant messaging.
- Desktop screen sharing / streaming.
- File sharing.
- Typing indicators.
- Message read-receipts.
- Profile encryption.
- Group messaging, voice and video conferencing.
Additional features can be implemented by any client, so long as they are supported by the core protocol. Features that are not related to the core networking system are left up to the client. 
The following instructions will install the "qTox" graphical user client. As qTox is not currently available as a stand-alone Debian package, users have three choices in late-2018:
- Build the package from source (difficult).
- Rely on an unsigned, self-contained AppImage downloaded from the Tox homepage (insecure).
- Install Flatpak from stretch-backports and then install Tox from the Flathub repository (easiest).
It is recommended to create a separate Whonix-Workstation before installing addtional software. Tox is also alpha software which has not been formally audited, therefore it is less trusted.
1. Boot Whonix-Workstation (
2. Add the current Debian stable backports codename
stretch-backports to Debian apt sources.
Note: this applies to Whonix 188.8.131.52.6. Later Whonix versions may use a codename different to
In Whonix-Workstation (
whonix-ws-14) TemplateVM, run.
sudo su -c "echo -e 'deb http://http.debian.net/debian stretch-backports main contrib non-free' > /etc/apt/sources.list.d/backports.list"
Alternatively, users who like Onionizing Repositories can set the .onion mirror.
sudo su -c "echo -e 'deb tor+http://vwakviie2ienjx6t.onion/debian stretch-backports main contrib non-free' > /etc/apt/sources.list.d/backports.list"
3. Update the package lists.
sudo apt-get update
4. Install the select software.
sudo apt-get -t stretch-backports install flatpak
The procedure is now complete.
On occasion it is necessary to undo this configuration, for example when upgrading from Debian
buster.  To proceed, run.
sudo rm /etc/apt/sources.list.d/backports.list
Add the Flathub Repository and Install qTox
Flathub is a common place to source Flatpak applications. To enable it, run.
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Next, restart Whonix-Workstation to allow flatpak to finish setting up.
To install qTox from flathub, open a terminal (Konsole) and run. 
flatpak install flathub io.github.qtox.qTox
To launch qTox, run.
flatpak run io.github.qtox.qTox
TODO: Add instructions on how to use Tox with Stream Isolation without Tor over Tor.
TODO: Add instructions for Qubes-Whonix.
Deprecated Chat Clients
Pidgin supports most protocols and OTR end-to-end encrypted chat. However, it is not recommended because it has a very poor security record with many remotely exploitable bugs. Security researcher and developer Micah Lee notes this is the result of reliance on legacy protocols and the libpurple, libotr and libxml libraries which are: "... massive, written in C/C++, and are littered with memory corruption bugs. ..." 
Whonix developers do no longer list RetroShare, which is a friend-to-friend (peer-to-peer), decentralized network and not an anonymizing network. Encrypted RetroShare connections support chat, voice and video, mail, file-sharing, forums and Tor.  Although RetroShare is under active development,  there are several serious concerns which disqualify a recommendation:
- The RetroShare package is signed with weak 1024-bit keys (in late-2018).
- A 2016 code review which focused on implementation vulnerabilities discovered multiple security issues: 
- The attack surface is high due to the feature-rich codebase.
- Systemic "insecure coding practice" was identified, particularly "...inconsistent return value checking and error handling, poor usage of explicit and implicit typecasting, and relaxed handling of adverse security edge-cases."
- Within a 24-hour period, auditors had developed proof of concept exploits for web-like vulnerabilities, weak binary protections, and out of bound memory reads and remote memory corruption (promptly rectified by developers).
- A coverity scan of the RetroShare code shows a large number of outstanding defects, along with a relatively high defect density.  
TorChat has not been recommended by Whonix developers since late-2015. The reason is development has been at a standstill since 2013 and the TorChat developer does not respond to other people, suggesting the project has been abandoned. TorChat is also an unofficial project and unaffiliated with The Tor Project. Since communication, support, active development and security fixes are essential for anonymity-related projects, Ricochet IM is strongly recommended as a modern, maintained alternative. 
It was found that although the design of TorChat is sound, its implementation has several flaws, which make TorChat users vulnerable to impersonation, communication confirmation and denial-of-service attacks.
Do not use Tor Messenger! It was deprecated by upstream developers in early-2018. 
For anonymous Voice over IP (VoIP) or encrypted, anonymous phone calls using the Tor anonymity network, see: VoIP.
If a messenger program is not listed in this chapter, it is for now recommended against. If readers feel any privacy-respecting chat clients are missing on this page, first search the Whonix forums to see if that application has been discussed in the recent past. Any additions to this page will be based on an objective analysis of the software's underlying strength and compatibility with Whonix. 
Footnotes / References
- See: https://tails.boum.org/todo/Pidgin_Protocol_Review/ for an overview of Pidgin protocols and associated encryption features.
- Other popular public servers are listed here.
- Tox has not yet been formally audited by security professionals, but this is the case for most software. Further, passing a formal audit does not guarantee that the software is in fact safe.
- Note this feature can be combined with OMEMO for encrypted file transfers.
- anon-apps-config which is installed by default will deactivate gajim plugin installer / updater because it is not secure.
- A new account can always be added with:
- To prevent needlessly leaking your activity to the server.
- For better security, this prevents the automatic start of these applications from the chat client.
- To set use of the Tor network, along with Stream Isolation.
/usr/local/etc/onion-grater-merger.d/because that onion-grater settings folder is persistent in Qubes-Whonix TemplateBased ProxyVMs, i.e. Whonix-Gateway (commonly called
sys-whonix). Non-Qubes-Whonix users could also use
/etc/onion-grater-merger.d/. Qubes-Whonix users could also use
/etc/onion-grater-merger.d/but then users would have to make
/etc/onion-grater-merger.d/persistent, which would require doing this inside the Whonix-Gateway TemplateVM (commonly called
whonix-gw-14) and restart their Whonix-Gateway ProxyVM or to use bind-dirs. Both is more complicated than simply using
/usr/local/etc/onion-grater-merger.d/which is persistent either way and even allows multiple Whonix-Gateway ProxyVMs based on the same Whonix-Gateway TemplateVM for lets say one Whonix-Gateway ProxyVM extending and relaxing onion-grater's whitelist and the other Whonix-Gateway ProxyVM with the default more restricted onion-grater whitelist.
- Depending on the mobile / desktop client in use.
- Users should Prefer Packages from Debian Stable Repository, but using backports is better than manual software installation or using third party package managers since this prefers APT. To contain the risk, Non-Qubes-Whonix users might want to consider using Multiple Whonix-Workstations and Qubes-Whonix users might want to consider using Multiple Qubes-Whonix TemplateVMs or Software Installation in a TemplateBasedVM.
- Most often this step applies before attempting major Whonix upgrades; upgrade instructions are also made available at that time (see Stay Tuned).
- Unlike other private P2P options, the F2F network can grow in size without compromising their users' identities. Also, passwords or digital signatures are required for authentication.
- See also: https://retroshareteam.wordpress.com/2018/03/13/release-notes-for-v0-6-4/
- For example, compare this result with the low number of defects and defect density of the Tor codebase.
- Particularly since Ricochet IM passed a recent (2016) security audit with flying colors.
- Security Analysis of Instant Messenger TorChat
- Also see: https://forums.whonix.org/t/client-server-instant-messengers-im-oct-2016
Whonix Chat wiki page Copyright (C) Amnesia <amnesia at boum dot org> Whonix Chat wiki page Copyright (C) 2012 - 2018 ENCRYPTED SUPPORT LP <firstname.lastname@example.org> This program comes with ABSOLUTELY NO WARRANTY; for details see the wiki source code. This is free software, and you are welcome to redistribute it under certain conditions; see the wiki source code for details.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.
Whonix is provided by ENCRYPTED SUPPORT LP. See Imprint.