HexChat: IRC Client

From Whonix
Jump to navigation Jump to search
HexChat Logo

Anonymous IRC Chat. HexChat (previously called XChat) over the Tor Anonymity Network.


HexChatarchive.org is an open source IRC client based on XChat. It includes basic functionality found in IRC clients, like secure connections, multiple server connections, nick completion, a client-to-client protocol, direct client-to-client file transfer and chat, and a plugin system which allows extension of features and further customization. [1] [2]

HexChat in Whonix has been hardened according to The Tor Project's Torrifying HexChat guide. [3] All servers, besides the secure (SSL) version of the Open and Free Technology Community (OFTC)archive.org have been removed. [4] It is recommended to add the securely encrypted version of the IRC server, preferably an onion service which uses SSL as a fallback or at best, both. Also see: Torifying HexChatarchive.org.

Note that the official #Tor channel is on OFTC, but no Whonix developers are active there! Upstream Tor developers do not support Whonix. For help with Whonix-related issues, see Support.


HexChat Operations[edit]

Start HexChat[edit]

If you are using Qubes-Whonix, complete the following steps.

Qubes App Launcher (blue/grey "Q")Whonix-Workstation AppVM (commonly named anon-whonix)HexChat IRC

If you are using a graphical Whonix-Workstation, complete the following steps.

Start menuApplicationsInternetHexChat IRC

Reset the HexChat Identity[edit]

Warning: This will kill HexChat, delete all settings, scripts and logs and finally create a fresh HexChat identity.

Open a terminal.

If you are using Qubes-Whonix, complete the following steps.

Qubes App Launcher (blue/grey "Q")Whonix-Workstation App Qube (commonly named anon-whonix)Xfce Terminal

If you are using a graphical Whonix with Xfce, run.

Start MenuXfce Terminal





Some networks and hidden IRC servers (like freenode) require Simple Authentication and Security Layer (SASL)archive.org to connect to them.

Setting up SASL is outside the scope of this entry; refer to The Tor Project SASL Authenticationarchive.org instructions.

Privacy Check[edit]

Before joining any channels, run the whois function from the status window.

/whois your-user-name your-user-name

The following example Chat (IRC client) screenshot shows the /whois output for user TNTBOMBOM (/whois TNTBOMBOM TNTBOMBOM).

Figure: IRC /whois Output

HexChat (IRC Client), showing /whois of oneself.

Disabling Hardening and File Transfers[edit]

Refer to this forum thread: Hexchat downloads?archive.org

IRC General[edit]

The Ident Protocol [5] is automatically blocked because Whonix-Workstation is firewalled. [6]

The Tor Project Internet Relay Chatarchive.org page contains general IRC safety techniques and other tips. Another useful resource is the IRC Securityarchive.org page. Key information and advice is provided on:

  • The importance of (additional) encrypted connections:
    • If an onion service is available, then use it. It is also safer to combine additional layers of encryption like SSL, TLS or GPG if possible.
    • If an IRC server uses a self-signed certificate, then explicitly check the SSL/TLS certificate is correct to prevent man-in-the-middle attacksarchive.org.
  • Avoiding Trojan Horse attacksarchive.org via malicious, downloaded files.
  • Defense against Denial of Service attacksarchive.org. [7]
  • Dangers associated with downloaded files.
  • Firewall considerations.
  • The impact of potential back-doors in IRC clients.
  • Circumvention of Tor censorship.
  • End-to-end encryption using OTR and other plugins.
  • Social safety measures to prevent de-anonymization.
  • Other miscellaneous security advice.

Connection Issues[edit]

If a message similar to the following appears.

* Closing Link: (No more connections permitted from your host)
* Disconnected (Remote host closed socket)

This most likely means the connection to the IRC server is working, but the server disconnects because they are not accepting Tor network connections. This is a general Tor censorship problem and unrelated to Whonix; see List Of Services Blocking Torarchive.org.

Unfortunately there is no easy solution and each available workaround has pros and cons:

  • Use an IRC alternative if this is feasible; see Chat for options.
  • If possible, use another Tor-friendly IRC network: List of IRC/chat networks that block or support Torarchive.org. [8]
  • Check if the IRC network provides a solution for Tor users. For example, OFTC and Torarchive.org.
  • Combine Tor with an additional tunnel link to circumvent blocks. [9] A connection to Tor must be made before the tunnel-link (proxy / VPN / SSH): UserTorproxy / VPN / SSHInternet.
  • Use an IRC bouncer; see Internet Relay Chatarchive.org. In the past, there were no trustworthy and free IRC bouncer services, but this situation may have changed in 2018. IRC bouncers are very affordable, but it is difficult to register and pay anonymously, see: Money.

To follow the associated Whonix development ticket, see: Migrating from IRC OFTC to Tor friendly IRC networkarchive.org.


Figure: HexChat IRC Client Chat Window

See Also[edit]


  1. https://en.wikipedia.org/wiki/HexChatarchive.org
  2. https://hexchat.github.io/archive.org
  3. https://gitlab.torproject.org/legacy/trac/-/wikis/doc/TorifyHOWTO/HexChatarchive.org
  4. This is an IRC network which provides collaboration services for members of the free software community, anywhere in the world.
  5. https://en.wikipedia.org/wiki/Ident_protocolarchive.org
  6. The Tor Project notesarchive.org:

    In both UNIX and Windows systems, the logged in username becomes the default ident. The ident is seen by most clients during channel join and when performing the /​whois command. It is therefore recommended to fake your ident before you connect to any IRC servers.

  7. Which otherwise can make networked computers disconnect or crash.
  8. Or conduct an Internet search for "Tor-friendly IRC server".
  9. This is a time-consuming and steep learning curve just to solve this issue.

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 12 year success story and maybe DONATE!