The hulk package

[ Tags: bsd3, library, network, program ] [ Propose Tags ]

An IRC server with (mandatory) server authentication, log recall, bumping. Intended for private business use or hobby work.

[Skip to Readme]


Versions 0.1, 0.1.1, 0.1.2, 0.2.0
Dependencies aeson, base (==4.*), bytestring, case-insensitive, cmdargs, ConfigFile, containers, Crypto, directory, fastirc, filepath, ghc-prim, monad-extras (==, mtl, network, split, strict, text, time, unix, utf8-string [details]
License BSD3
Copyright 2010-2013 Chris Done
Author Chris Done
Category Network
Uploaded Sun Nov 3 06:06:04 UTC 2013 by ChrisDone
Distributions NixOS:0.2.0
Executables hulk-generate-pass, hulk
Downloads 876 total (7 in the last 30 days)
Rating 0.0 (0 ratings) [clear rating]
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]
Hackage Matrix CI


  • Hulk
    • Hulk.Auth
    • Hulk.Client
    • Hulk.Config
    • Hulk.Options
    • Hulk.Server
    • Hulk.Types



Maintainer's Corner

For package maintainers and hackage trustees

Readme for hulk-0.2.0

[back to package description]

Hulk IRC Server Guide


From Hackage

$ cabal install hulk

From Github

$ git clone git://
$ cd hulk
$ cabal install


See a complete example in the example/ directory in the root of the project. You can go into that directory and run hulk -chulk.conf to have an immediate server running on localhost port 6667.


$ cp example/hulk.conf hulk.conf

You can edit the port, server name and MOTD file in here.

Detailed instructions follow.


$ mkdir auth

Put a salt for your passwords in auth/passwd. For example:

$ head -c 128 /dev/random | sha1sum > auth/passwd-key

Then generate a password for your IRC user:

$ hulk-generate-pass -u demo -c=hulk.conf >> auth/passwd

(It will wait for a single line containing a pass and output the user and sha1 sum.)

Start the server

$ hulk -chulk.conf

Logs / events will be outputted to stdout. This will be a configuration option later. (Send me a patch if you already did this!)

Clients must connect with a password and user that matches the users and passwords in your auth/passwd file.

Using with SSL

You can use it with stunnel.

Change the port setting in hulk.conf:

port = 6666

Generate an SSL certificate:

$ openssl req -new -out hulk.pem -keyout hulk.pem -nodes -x509 -days 365

Make a stunnel.conf file:

pid = /path/to/wherever/
client = no
foreground = yes
output = /dev/stdout
cert = hulk.pem
connect =
accept = 6667

Then run it:

stunnel stunnel.conf

(It may be in /usr/sbin/stunnel depending on your system.)

Then run hulk:

hulk -chulk.conf


Hulk doesn't support specific channel logging yet, but you can use a logger bot.

$ cabal install hog
$ hog -h= --port=6666 -n=hog -u=hog --pass=mypassword --channels=#dev,#x -l/directory/of/logs -d5

-d5 is the timeout before reconnect.

Using an announcer bot

If you're using a private IRC server you're probably using it at a dev company, and you probably want to make announcements about commits, tickets, etc. from a feed.

You can use rss2irc. But you need a patched version which supports sending the PASS command:

$ git clone git://
$ cd rss2irc
$ cabal install

Then run it:

$ rss2irc http://myserver/foo.atom announce@ \
  -p 6667 -i 1 -l  --pass myannouncepass