ruk·si

Installing IRC bouncer

Updated at 2015-04-20 05:54
  1. Get a Linux server and install ZNC (bouncer) on it.
  2. Create ZNC configuration.
    znc --makeconf
    # Will create config at ~/.znc/configs/znc.conf
    
    What port would you like ZNC to listen on? (1025 to 65535): AN_OPEN_PORT
    Would you like ZNC to listen using SSL? (yes/no) [no]: no
    Would you like ZNC to listen using ipv6? (yes/no) [yes]: no
    Listen Host (Blank for all ips): BLANK_OR_VPS_IP_HERE
    
    Load global module <partyline>? (yes/no) [no]: no
    Load global module <webadmin>? (yes/no) [no]: no
    
    Username (AlphaNumeric): username-irc-network-name
    Enter Password: CHOOSE_PASSWORD
    Confirm Password: CHOOSE_PASSWORD
    Would you like this user to be an admin? (yes/no) [yes]: yes
    Nick [omatunnukseni]: your-irc-username
    Alt Nick [omatunnukseni_]: your-irc-username_
    Ident [omatunnukseni]: username-irc-network-name
    Real Name [Got ZNC?]: Your Real Name If You Want
    Bind Host (optional): BLANKS_OR_IP_THAT_IS_USED_TO_CONNECT_TO_IRC
    Number of lines to buffer per channel [50]:
    Would you like to keep buffers after replay? (yes/no) [no]:
    Default channel modes [+stn]:
    
    Load module <admin>? (yes/no) [no]:
    Load module <chansaver>? (yes/no) [no]: yes # channels saved on join/leave
    Load module <keepnick>? (yes/no) [no]:
    Load module <kickrejoin>? (yes/no) [no]:
    Load module <nickserv>? (yes/no) [no]:
    Load module <perform>? (yes/no) [no]:
    Load module <simple_away>? (yes/no) [no]:
    
    IRC server (host only): irc.example.fi
    [irc.example.fi] Port (1 to 65535) [6667]:
    [irc.example.fi] Password (probably empty):
    Does this server use SSL? (yes/no) [no]:
    
    IRC server (host only): irc.example.com (same network, backup server)
    [irc.example.com] Port (1 to 65535) [6667]: 6663
    [irc.example.com] Password (probably empty):
    Does this server use SSL? (yes/no) [no]:
    
    Launch ZNC now? (yes/no) [yes]: yes
    
  3. Make ZNC to restart on reboot.
    (crontab -l; echo "@reboot sleep 300; znc") | crontab -
    
  4. Connect to the bouncer using an IRC client.
    OS X: Textual (~$5, awesome IRC client)
    Windows: IceChat (free, decent after some configuration)
        > View > Themes > Default
        > Options > Font Settings... > Change all to Consolas 12
        > Options > Color Settings
            > Server Tree/Tabs
                > Change all channel colors to white except
                  new message, new action, server message and server notice.
                > Change current Tab to black.
        > Add Server
            > Main Settings
                > Ident name: BNC login username
            > Extra Settings
                > Server password: BNC login password
    
  5. If you want to edit the configuration.
    pkill -SIGUSR1 znc
    pkill znc
    # edit ~/.znc/configs/znc.conf.
    znc