Installing psyBNC and using it


Downloading psyBNC:

  1. At the shell prompt, type:get-psybnc

    Alternative method:

Compiling psyBNC:

  1. At the shell prompt, type:nano .nanorc
  2. Make these changes to .nanorc:set nowrap

    Save & exit.

  3. At the shell prompt, type:
    • cd psybnc
    • nano config.h
  4. Make these changes to config.h:
    • #define CRYPT
    • #define BLOWFISH
    • #define MULTIUSER
    • #define MAXUSER 20
    • #define MAXCONN 40
    • #define BLOCKDNS
    • #define NETWORK
    • #define SCRIPTING
    • #define PROXYS
    • #define LOGLEVEL 0
    • #define CTCPVERSION “[CTCP version response shown when not connected to psyBNC]
    • #define SSLSEC 2

    Only define these options if required:

    • #define INTNET (Enables ircd)
    • #define LINKAGE (Enables linkage)
    • #define DCCFILES (Enables DCC get and send)
    • #define DCCCHAT (Enables DCC chat)

    Save & exit.

  5. At the shell prompt, type:
    • make
    • mkdir backup
    • mv salt.h backup

Configuring psyBNC:

  1. At the shell prompt, type:nano psybnc.conf
  2. Make these changes to psybnc.conf:
    • PSYBNC.HOSTALLOWS.ENTRY0=*;*
    • PSYBNC.SYSTEM.ME=[bouncer name] (bnc01, mybouncer, psybnc1, etc..)
    • PSYBNC.SYSTEM.HOST1=[your shell IP address] (Sent to you via email)
    • PSYBNC.SYSTEM.PORT1=[the port psyBNC will listen on] (Valid range: 1000-65535. Avoid port 31337.)
    • USER1.USER.VHOST=[your vhost IP address]
    • USER1.USER.LOGIN=[username] (Select a psyBNC login name)
    • USER1.USER.PASS=[password] (Select a psyBNC password)
    • USER1.USER.USER=[real name] (Your real name in /whois)
    • USER1.USER.NICK=[IRC nickname]
    • USER1.USER.AWAYNICK=[away nickname]
    • USER1.USER.AUTOREJOIN=0 (Disables auto rejoin when not connected to psyBNC, default=1)
    • USER1.USER.DCCENABLED=0 (Disables DCC, default=1)
    • USER1.USER.RIGHTS=1 (Enables admin rights, default=1)
    • USER1.USER.VLINK=0 (Disables linkage, default=1)
    • USER1.USER.AIDLE=1
    • USER1.USER.AUTOGETDCC=0
    • USER1.USER.CERT=+
    • USER1.USER.LASTLOG=0
    • USER1.USER.LEAVEQUIT=1
    • USER1.USER.PARENT=0
    • USER1.USER.PPORT=0
    • USER1.USER.QUITTED=0
    • USER1.USER.SYSMSG=1
    • USER1.SERVERS.SERVER1=[IRC server IP address] (First server psyBNC will connect to)
    • USER1.SERVERS.PORT1=[IRC server port #]
    • USER1.CHANNELS.ENTRY0=[#channel name] (First channel psyBNC will join)
    • USER1.CHANNELS.KEY0=[channel key] (First channel key)
    • USER1.CHANNELS.ENTRY1=[#channel name]
    • USER1.CHANNELS.KEY1=[channel key]

    Save & exit.

  3. At the shell prompt, type:
    • more psybnc.conf (Review your settings)
    • ./psybnc (Launch psyBNC and Review any errors which may result)
    • ps x (Verify that psyBNC is running)
    • kill -9 [PID, process ID] (Only if you need to stop the process)
    • export VISUAL=’nano’
    • pwd (Path to psybnc folder, required for next step.)
    • crontab -e
  4. Make the following changes to your crontab file:0,10,20,30,40,50 * * * * /[path to psybnc folder]/psybncchk >/dev/null 2>&1

    Save & exit.

  5. At the shell prompt, type:
    • crontab -l (Review your settings)
    • chmod 700 psybncchk
    • nano psybncchk
  6. Make the following changes to psybncchk:PSYBNCPATH=[path to psybnc folder]

    Save & exit.

Configuring mIRC options:

  1. Tools – Options – Connect:
    • Full Name: [your real name, same as USER1.USER.USER in psybnc.conf]
    • Email Address: [your psyBNC login name, same as USER1.USER.LOGIN in psybnc.conf]@anydomain.com
    • Nickname: [your IRC nickname, same as USER1.USER.NICK in psybnc.conf]
  2. Tools – Options – Connect – Local Info:
    • On connect, always get: Local Host
    • Lookup Method: Server
  3. Tools – Options – Connect – Identd:Disable Identd server

    You do not need to run an Identd server. PsyBNC will use the Email Address field as your login name.

  4. Tools – Options – Connect – Servers:Add a new server.
    • IRC Server: [your shell IP, same as PSYBNC.SYSTEM.HOST1 in psybnc.conf]
    • Ports: [your psyBNC port, same as PSYBNC.SYSTEM.PORT1 in psybnc.conf]
    • Password: [your psyBNC password, same as USER1.USER.PASS in psybnc.conf]

    Save & initiate a connection to the server. (Remember to press ‘Select’ in the mIRC server settings dialog or incorrect information will be used when you press ‘Connect’.)

  5. Once connected to psyBNC, the following options become available:
    • /bvhost [your vhost IP address]
    • /addserver [IRC server IP address] :[IRC server port #]
    • /listservers
    • /j [#channel name] (Channel you want psyBNC to join)
    • /bconnect (Connect psyBNC to IRC servers)
    • /bquit (Disconnect psyBNC from IRC servers)
    • /bhelp (Query help file)

    For a list of all available options please refer to a full psyBNC FAQ or tutorial.


Downloading psyBNC:

  1. At the shell prompt, type:get-psybnc

    Alternative method:

Compiling psyBNC:

  1. At the shell prompt, type:nano .nanorc
  2. Make these changes to .nanorc:set nowrap

    Save & exit.

  3. At the shell prompt, type:
    • cd psybnc
    • nano config.h
  4. Make these changes to config.h:
    • #define CRYPT
    • #define BLOWFISH
    • #define MULTIUSER
    • #define MAXUSER 20
    • #define MAXCONN 40
    • #define BLOCKDNS
    • #define NETWORK
    • #define SCRIPTING
    • #define PROXYS
    • #define LOGLEVEL 0
    • #define CTCPVERSION “[CTCP version response shown when not connected to psyBNC]
    • #define SSLSEC 2

    Only define these options if required:

    • #define INTNET (Enables ircd)
    • #define LINKAGE (Enables linkage)
    • #define DCCFILES (Enables DCC get and send)
    • #define DCCCHAT (Enables DCC chat)

    Save & exit.

  5. At the shell prompt, type:
    • make
    • mkdir backup
    • mv salt.h backup

Configuring psyBNC:

  1. At the shell prompt, type:nano psybnc.conf
  2. Make these changes to psybnc.conf:
    • PSYBNC.HOSTALLOWS.ENTRY0=*;*
    • PSYBNC.SYSTEM.ME=[bouncer name] (bnc01, mybouncer, psybnc1, etc..)
    • PSYBNC.SYSTEM.HOST1=[your shell IP address] (Sent to you via email)
    • PSYBNC.SYSTEM.PORT1=[the port psyBNC will listen on] (Valid range: 1000-65535. Avoid port 31337.)
    • USER1.USER.VHOST=[your vhost IP address]
    • USER1.USER.LOGIN=[username] (Select a psyBNC login name)
    • USER1.USER.PASS=[password] (Select a psyBNC password)
    • USER1.USER.USER=[real name] (Your real name in /whois)
    • USER1.USER.NICK=[IRC nickname]
    • USER1.USER.AWAYNICK=[away nickname]
    • USER1.USER.AUTOREJOIN=0 (Disables auto rejoin when not connected to psyBNC, default=1)
    • USER1.USER.DCCENABLED=0 (Disables DCC, default=1)
    • USER1.USER.RIGHTS=1 (Enables admin rights, default=1)
    • USER1.USER.VLINK=0 (Disables linkage, default=1)
    • USER1.USER.AIDLE=1
    • USER1.USER.AUTOGETDCC=0
    • USER1.USER.CERT=+
    • USER1.USER.LASTLOG=0
    • USER1.USER.LEAVEQUIT=1
    • USER1.USER.PARENT=0
    • USER1.USER.PPORT=0
    • USER1.USER.QUITTED=0
    • USER1.USER.SYSMSG=1
    • USER1.SERVERS.SERVER1=[IRC server IP address] (First server psyBNC will connect to)
    • USER1.SERVERS.PORT1=[IRC server port #]
    • USER1.CHANNELS.ENTRY0=[#channel name] (First channel psyBNC will join)
    • USER1.CHANNELS.KEY0=[channel key] (First channel key)
    • USER1.CHANNELS.ENTRY1=[#channel name]
    • USER1.CHANNELS.KEY1=[channel key]

    Save & exit.

  3. At the shell prompt, type:
    • more psybnc.conf (Review your settings)
    • ./psybnc (Launch psyBNC and Review any errors which may result)
    • ps x (Verify that psyBNC is running)
    • kill -9 [PID, process ID] (Only if you need to stop the process)
    • export VISUAL=’nano’
    • pwd (Path to psybnc folder, required for next step.)
    • crontab -e
  4. Make the following changes to your crontab file:0,10,20,30,40,50 * * * * /[path to psybnc folder]/psybncchk >/dev/null 2>&1

    Save & exit.

  5. At the shell prompt, type:
    • crontab -l (Review your settings)
    • chmod 700 psybncchk
    • nano psybncchk
  6. Make the following changes to psybncchk:PSYBNCPATH=[path to psybnc folder]

    Save & exit.

Configuring mIRC options:

  1. Tools – Options – Connect:
    • Full Name: [your real name, same as USER1.USER.USER in psybnc.conf]
    • Email Address: [your psyBNC login name, same as USER1.USER.LOGIN in psybnc.conf]@anydomain.com
    • Nickname: [your IRC nickname, same as USER1.USER.NICK in psybnc.conf]
  2. Tools – Options – Connect – Local Info:
    • On connect, always get: Local Host
    • Lookup Method: Server
  3. Tools – Options – Connect – Identd:Disable Identd server

    You do not need to run an Identd server. PsyBNC will use the Email Address field as your login name.

  4. Tools – Options – Connect – Servers:Add a new server.
    • IRC Server: [your shell IP, same as PSYBNC.SYSTEM.HOST1 in psybnc.conf]
    • Ports: [your psyBNC port, same as PSYBNC.SYSTEM.PORT1 in psybnc.conf]
    • Password: [your psyBNC password, same as USER1.USER.PASS in psybnc.conf]

    Save & initiate a connection to the server. (Remember to press ‘Select’ in the mIRC server settings dialog or incorrect information will be used when you press ‘Connect’.)

  5. Once connected to psyBNC, the following options become available:
    • /bvhost [your vhost IP address]
    • /addserver [IRC server IP address] :[IRC server port #]
    • /listservers
    • /j [#channel name] (Channel you want psyBNC to join)
    • /bconnect (Connect psyBNC to IRC servers)
    • /bquit (Disconnect psyBNC from IRC servers)
    • /bhelp (Query help file)

    For a list of all available options please refer to a full psyBNC FAQ or tutorial.