Shells ZNC

From Insomnia 24/7 Wiki
Jump to: navigation, search

Since we got a lot of people using ZNC, we installed it on the server so you no longer have to compile it yourself. To get started using your own ZNC client pick a open port you can use (see ports page for more info on this).

Next we tell ZNC to make a new config file for us:

znc --makeconf

It will ask you a few configuration questions:

[ ?? ] What port would you like ZNC to listen on? (1 to 65535): <port you picked>
[ ?? ] Would you like ZNC to listen using SSL? (yes/no) [no]: yes (You can pick no, but SSL is better security wise)
[ ?? ] Would you like ZNC to listen using ipv6? (yes/no) [no]: no
[ ?? ] Listen Host (Blank for all ips): <leave blank>

Then it will ask you if you want to load any global modules, normally you won't have to:

[ ?? ] Do you want to load any global modules? (yes/no): no

Now it will ask you for your user configuration:

[ ?? ] Username (AlphaNumeric): yournick
[ ?? ] Enter Password: <enter a password to connect to your znc here>
[ ?? ] Confirm Password: <and again>
[ ?? ] Would you like this user to be an admin? (yes/no) [yes]: yes
[ ?? ] Nick [yournick]: <press enter>
[ ?? ] Alt Nick [yournick_]: <press enter>
[ ?? ] Ident [yournick: <press enter>
[ ?? ] Real Name [Got ZNC?]: <press enter or set something you want
[ ?? ] VHost (optional): <press enter>
[ ?? ] Would you like ZNC to keep trying for your primary nick? (yes/no) [no]: <press enter>
[ ?? ] Number of lines to buffer per channel [50]: <press enter>
[ ?? ] Would you like to keep buffers after replay? (yes/no) [no]: <press enter>
[ ?? ] Default channel modes [+stn]: <press enter>

Now it will ask you if you want to load any user modules, again, this is normally not needed.

[ ?? ] Do you want to automatically load any user modules for this user? (yes/no): no

Now it's time to add IRC servers and channels it will connect to for you.

[ ?? ] IRC server (host only): irc.insomnia247.nl
[ ?? ] [irc.insomnia247.nl] Port (1 to 65535) [6667]: 6669
[ ?? ] [irc.insomnia247.nl] Password (probably empty): ,leave empty unless you need a password to connect to the server
[ ?? ] Does this server use SSL? (probably no) (yes/no) [no]: yes
[ ?? ] Would you like to add another server? (yes/no) [no]: no
[ ?? ] Would you like to add a channel for ZNC to automatically join? (yes/no) [yes]: yes
[ ?? ] Channel name: #shells
[ ?? ] Would you like to add another channel? (yes/no) [no]: no

Now finally you get the chance to set up another user for ZNC, this is also normally not needed as it's only you that uses it.

[ ?? ] Would you like to setup another user? (yes/no) [no]: no

Finally it will ask you if you want to start ZNC now, you can pick yes here, but it will usually fail with "[No such file or directory]"

[ ?? ] Launch znc now? (yes/no) [yes]:
[ ** ] Unable to launch znc [No such file or directory]

If you have configured your ZNC with SSL, it will need to create a .pem file (SSL certificate) when you run ZNC, you will be prompted to do so.

User@Lydia:~$ znc
[ ?? ] Would you like to create a new pem file? (yes/no) [yes]: yes
[ ?? ] hostname of your shell (including the '.com' portion): insomnia247.nl

Your ZNC should now be up and running, you can connect to it from your normal IRC client with the command

/server insomnia247.nl port yournick:yourpassword

Don't forget to include the -ssl option if you configured it to use SSL.