Public | Automated Build

Last pushed: 7 days ago
Short Description
WeeChat IRC client container is a docker container you run on a server and connect to over ssh.
Full Description


WeeChat IRC client container is a docker container you run on a server and connect to over ssh. It comes with some plugins and scripts preinstalled and it bundles its own Tor entry node to allow for secure connections to .onion addresses.

Please note, that I am not affiliated with the development of neither Docker nor WeeChat nor Tor, I am just the one bundling this container.


Installing the container is easy but requires some configurational steps.

  1. Start a dummy container for presistent storage of all configuration docker run --name weechat-data kerwindena/weechat /bin/true
  2. Get the path to the volume of the data container. This can be easily done with docker inspect weechat-data | grep Source | sed -r 's/.*"(.*)",/\1/'
  3. Optional: For convinient access to the configuration you might want to symlink it to a more intuitive place
  4. Add your ssh keys to the authorized_keys located in the config directory
  5. Start the container, link the weechat-data volumes and expose the port. This could be done with docker run --volumes-from=weechat-data --restart=always --name weechat -p 5000:22 -d kerwindena/weechat.


What about Tor?

tl;rd: Yes, what about it? It is a tiny demon running, establishing a circuit and not sending any data through it, as long as you don't use it. No harm done.

The Tor daemon is running with its default configuration. This means, it is configured as an entry node, so it can be used to route request through the tor network but it does not relay any data from the network. The entry node can be only used from inside the container and there is no data of somebody else to be sent and explicitly there is nothing unencrypted leaving the network. This is great if you don't want to get involved but bad for the network, since you can use it, but don't give anythig back. If this botheres you as it botheres me you might want consider to leave this demon as it is and start another tor daemon outside the container, maybe in another container.

How do I route a connection through the tor network?

WeeChat should have a tor-proxy configured by default in this container. You can verify this with /proxy list. If it is missing, please issue a bug and recreate it with /proxy add tor socks5 9050.
You can activate the tor proxy on a per-server basis by simply using /set irc.server.<servername>.proxy tor replaceing <servername> with the configured name of the server.

Docker Pull Command
Source Repository