ZNC IRC Proxy

ZNC is a lot like dircproxy, but it works much better, is easier to use, and has built in ssl.

installation

   1. Download Tarball


   2. tar -xzvf znc*.*gz


   3. cd znc*


   4. ./configure --prefix=/usr/local --with-openssl


   5. make


   6. make install

configuration

First, lets create a PEM format certficate. This cert will be used for the connection between znc and our irc client:

> znc --makepem

It will ask you for the hostname of the server running znc.

Now we need to create a configuration file. Just run:

> znc --makeconf

It will walk you through all the configuration options. Here are some useful values:

[ ?? ] What port would you like ZNC to listen on? (1 to 65535): 57000


[ ?? ] Would you like ZNC to listen using SSL? (yes/no) [no]: yes


[ ?? ] Listen Host (Blank for all ips):


[ ?? ] Number of lines to buffer per channel [50]: 1000


[ ?? ] Would you like your buffer to be sticky? (yes/no) [yes]:





[ ?? ] Load system module <autoattach>? (yes/no) [no]: yes


[ ?? ] Load system module <away>? (yes/no) [no]: yes


[ ?? ] Load system module <crypt>? (yes/no) [no]: yes


[ ?? ] Load system module <savebuff>? (yes/no) [no]: yes


[ ?? ] Load system module <schat>? (yes/no) [no]: yes


[ ?? ] Load system module <stickychan>? (yes/no) [no]: yes


[ ?? ] Load system module <watch>? (yes/no) [no]: yes





[ ?? ] IRC server (host only): irc.indymedia.org


[ ?? ] [irc.indymedia.org] Port (1 to 65535) [6667]: 994


[ ?? ] [irc.indymedia.org] Password (probably empty):


[ ?? ] Does this server use SSL? (probably no) (yes/no) [no]: yes

The --makeconf command will create a hashed password for you. If you want to change the password stored in the znc.conf file, use this command:

> znc --makepass

Copy this hash to your znc.conf file to control access to the znc proxy.

see wiki.rottenboy.com/index.php/Configuration for all options.

running znc

Just type 'znc' on the command line, as your user. It will background itself. If you have enabled away and savebuff user modules, it will ask you for a password, used to encrypt these log files.

connecting to znc

irssi

/server host.running.znc 57000 blue:pass

xchat:

Servers: host.running.znc/57000
Use SSL for all the servers on this network: yes
Accept invalid SSL certificates: yes
Server password: the password you specified in "znc --makeconf"

controlling znc

You can communicate with your znc proxy through irc by sending messages to status.

For example:

/msg *status help

If you have away installed, it will log private messages sent to you while you are idle. This way, if you shut down your client and come back later, you can replay the messages you might have missed:

/msg *away show


/msg *away delete all