User Tools

Site Tools


software:cli:znc

Setup of the ZNC bouncer

Install

Nothing special here, use your package manager

Configuration

First time

Log as your user and launch

znc --makeconf

select the port

[ ?? ] What port would you like ZNC to listen on? (1025 to 65535): 65535
[ ?? ] Would you like ZNC to listen using SSL? (yes/no) [no]: yes
[ ** ] Unable to locate pem file: [/home/warnaud/.znc/znc.pem]
[ ?? ] Would you like to create a new pem file now? (yes/no) [yes]: 
[ ok ] Writing Pem file [/home/warnaud/.znc/znc.pem]... 
[ ?? ] Would you like ZNC to listen using ipv6? (yes/no) [yes]: no
[ ?? ] Listen Host (Blank for all ips):
[ ok ] Verifying the listener... 
[ ** ] 
[ ** ] -- Global Modules --
[ ** ] 
[ ** ] +-----------+----------------------------------------------------------+
[ ** ] | Name      | Description                                              |
[ ** ] +-----------+----------------------------------------------------------+
[ ** ] | partyline | Internal channels and queries for users connected to znc |
[ ** ] | webadmin  | Web based administration module                          |
[ ** ] +-----------+----------------------------------------------------------+
[ ** ] And 13 other (uncommon) modules. You can enable those later.
[ ** ] 
[ ?? ] Load global module <partyline>? (yes/no) [no]:
[ ?? ] Load global module <webadmin>? (yes/no) [no]: yes
[ ** ] 
[ ** ] Now we need to set up a user...
[ ** ] ZNC needs one user per IRC network.
[ ** ] 
[ ?? ] Username (AlphaNumeric):
[ ?? ] Enter Password: 
[ ?? ] Confirm Password: 
[ ?? ] Would you like this user to be an admin? (yes/no) [yes]: 
[ ?? ] Nick [warnaud]: Warnaud
[ ?? ] Alt Nick [Warnaud_]: 
[ ?? ] Ident [Warnaud]: 
[ ?? ] Real Name [Got ZNC?]: Arnaud Fortier
[ ?? ] Bind Host (optional): 
[ ?? ] Number of lines to buffer per channel [50]: 200
[ ?? ] Would you like to keep buffers after replay? (yes/no) [no]: 
[ ?? ] Default channel modes [+stn]: 
[ ** ] 
[ ** ] -- User Modules --
[ ** ] 
[ ** ] +-------------+------------------------------------------------------------------------------------------------------------+
[ ** ] | Name        | Description                                                                                                |
[ ** ] +-------------+------------------------------------------------------------------------------------------------------------+
[ ** ] | admin       | Dynamic configuration of users/settings through IRC. Allows editing only yourself if you're not ZNC admin. |
[ ** ] | chansaver   | Keep config up-to-date when user joins/parts                                                               |
[ ** ] | keepnick    | Keep trying for your primary nick                                                                          |
[ ** ] | kickrejoin  | Autorejoin on kick                                                                                         |
[ ** ] | nickserv    | Auths you with NickServ                                                                                    |
[ ** ] | perform     | Keeps a list of commands to be executed when ZNC connects to IRC.                                          |
[ ** ] | simple_away | Auto away when last client disconnects                                                                     |
[ ** ] +-------------+------------------------------------------------------------------------------------------------------------+
[ ** ] And 36 other (uncommon) modules. You can enable those later.
[ ** ] 
[ ?? ] Load module <admin>? (yes/no) [no]: yes
[ ?? ] Load module <chansaver>? (yes/no) [no]: 
[ ?? ] Load module <keepnick>? (yes/no) [no]: 
[ ?? ] Load module <kickrejoin>? (yes/no) [no]: 
[ ?? ] Load module <nickserv>? (yes/no) [no]: yes
[ ?? ] Load module <perform>? (yes/no) [no]: 
[ ?? ] Load module <simple_away>? (yes/no) [no]: 
[ ** ] 
[ ** ] -- IRC Servers --
[ ** ] Only add servers from the same IRC network.
[ ** ] If a server from the list can't be reached, another server will be used.
[ ** ] 
[ ?? ] IRC server (host only): dns2.test.local
[ ?? ] [dns2.test.local] Port (1 to 65535) [6667]: 
[ ?? ] [dns2.test.local] Password (probably empty): 
[ ?? ] Does this server use SSL? (yes/no) [no]: 
[ ** ] 
[ ?? ] Would you like to add another server for this IRC network? (yes/no) [no]: 
[ ** ] 
[ ** ] -- Channels --
[ ** ] 
[ ?? ] Would you like to add a channel for ZNC to automatically join? (yes/no) [yes]: 
[ ?? ] Channel name: &bitlbee
[ ?? ] Would you like to add another channel? (yes/no) [no]: 
[ ** ] 
[ ?? ] Would you like to set up another user (e.g. for connecting to another network)? (yes/no) [no]: 
[ ok ] Writing config [/home/warnaud/.znc/configs/znc.conf]... 
[ ** ] 
[ ** ] To connect to this ZNC you need to connect to it as your IRC server
[ ** ] using the port that you supplied.  You have to supply your login info
[ ** ] as the IRC server password like this: user:pass.
[ ** ] 
[ ** ] Try something like this in your IRC client...
[ ** ] /server <znc_server_ip> +65535 warnaud:<pass>
[ ** ] And this in your browser...
[ ** ] https://<znc_server_ip>:65535/
[ ** ] 
[ ?? ] Launch ZNC now? (yes/no) [yes]:

References

software/cli/znc.txt · Last modified: 2021/12/29 21:09 by warnaud