psyBNC – Quick Setup Guide by talos
Before you get started, type vhosts after you've logged into your shell and pick out the vhost you want to use once you connect to your IRC server(s). Follow the next three steps:
1. wget http://www.psybnc.net/psyBNC-2.3.2-7.tar.gz 2. tar zxvf psyBNC-2.3.2-7.tar.gz 3. cd psybnc 4. make menuconfig
At this point, you should have a graphical interface in front of you. Highlight Compiling Options and press ENTER. Most of these options you will leave alone, but there are a few you should toggle. Highlight Support Scripting and press ENTER, then highlight Support Proxy Usage and press ENTER; then highlight Exit (at the bottom, use the right arrow) and press ENTER.
You should now be back at the main menu. Highlight Bouncer-Config and press ENTER. By default, Listening Ports should be highlighted; go ahead and hit ENTER. You should change the port used for incoming connections; the default port of 31337 usually gets slammed with numerous connection attempts. Press ENTER, and erase everything in the box (by everything, I mean * 31337 ). Depending on which server you're using, enter the server name and port separated by a space. For example, if you're on freddie and you want to use port 44444, you would type freddie.veritynet.net 44444. You'll want to choose a port between 30000 and 45000, as these are usually available and not blocked by VerityNet's firewall. Once you've entered the server name and port, press ENTER, then press ESC.
At this point, I'm going to assume you aren't linking your psyBNC to anyone else's; I'm also going to assume you aren't going to be sharing your psyBNC with any friends, so you can skip Host Allows as well.
Highlight Users and press ENTER. You should see a box with no text inside of it. Don't worry, this is a good thing. Hightlight New by using the right arrow, and press ENTER. Here is an explanation of the fields you should modify on the new screen: Login Whatever your ident is set to in your IRC client Nick Whatever you want your nickname to be on IRC Username This is the same as the "Real Name" field in mIRC Password Set this to whatever you want your password to be VHost Remember that vhost from earlier? Type it here Rights You should set this to Admin for your username only
Before you leave this screen, go all the way to the bottom and highlight Servers --->, then press ENTER. This is where you tell psyBNC what servers you want to connect to; it's also where things can get a little tricky. If you want to connect to multiple networks (e.g. EFnet and Linknet), we'll enter one now, and the other once you've started your psyBNC. Press ENTER again and you should be prompted to enter a hostname or IP and a port separated by a space. If you want to connect to a non-SSL network (like EFnet), you'd enter irc.easynews.com 6667 and press ENTER. You should replace irc.easynews.com with your preferred server. If you want to connect to a SSL-enabled network (like Linknet), you'll have to put S= in front of your server name. For example, to connect to Linknet, you'd enter S=irc.thedome.us 7000 and press ENTER. Again, you should replace irc.thedome.us with your preferred server. I also recommend adding more than one server; that way if one server is down or won't let you connect, psyBNC will skip to the next in the list.
Once you've entered your server(s), press ESC, then highlight Exit by using the right arrow and press ENTER. You should now be at the Users menu, and you should see your login listed. If you don't, you'll have to re-enter all your information. If this problem persists, join #veritynet on EFnet and ask for help. If you do see your login though, press ESC to return to the Bouncer-Config, then highlight Exit by using the right arrow and press ENTER.
You're almost done! Highlight Exit one more time and press ENTER. You should now be back at the command line. Type gmake and press ENTER. You should see a lot of text scroll by; don't worry, this is normal. If you see a lot of warning messages, again, don't worry, it's normal. Once the text stops flying by, you'll be asked to enter your country name. You can just hit enter for the six pieces of information it asks for, it'll use the default value in the [ ] braces. Once you come back to the command line, you should type mv salt.h salt.bak. This file contains your encryption key; psyBNC will yell at you until you move the file.
Now for the moment of truth; type ./psybnc and you should see it start up. To make sure it started, type ps x and you should see a line similar to 4502 p1 S 0:00.02 ./psybnc in the list. If you don't, try changing your port number. If that doesn't work, join #veritynet on EFnet and ask for help.
IRC client configuration
So by now you should have your psyBNC running. Since mIRC and XChat seem to be the most popular IRC clients, here are some tips for getting them to connect to your psyBNC:
For mIRC: Open the Options and click the Connect item on the left. Set Full Name to whatever you want; set Email Address to firstname.lastname@example.org (login should be whatever you set your login to be on the bnc); you should know what to do with Nickname and Alternative. Under Connect on the left, click Servers . Click the Add button; set IRC Server to the server you're on (my example earlier was 'freddie.veritynet.net'); set Port(s) to the port you chose (my example earlier was '44444'). Under Servers on the left, click Identd. Check Use ID from email address. Go back to Servers on the left, find your server, and hit the Connect To Server button. If you see a message from -psyBNC saying "Disconnected. Wrong Password" or something similar, make sure you set your ident correctly in mIRC, and if that doesn't help, join #veritynet on EFNet and ask for help.
For XChat: Open the Server List. Set User Name to the login you chose for your psyBNC; set Real Name to whatever you want. Click the Add button; name the server something you'll recognize (I usually name the server "Network (shell server)"; for example, "EFNet (freddie)"). Click Edit on the right; click Edit on the new dialog box and type the shell server that you compiled your psyBNC on and the port that you set separated by a "/". My example earlier was 'freddie.veritynet.net' and port '44444', so you would type freddie.veritynet.net/44444. Under Connecting, you can choose to have XChat auto-connect to your psyBNC when you start; my preference is to let it do so. Uncheck Use a proxy server . Click Close, make sure the server you just added is highlighted, and click Connect. If you see a message from -psyBNC saying "Disconnected. Wrong Password" or something similar, make sure you set your username correctly in XChat, and if that doesn't help, join #veritynet on EFNet and ask for help.
Setting up multiple networks
So now you should be connected to your psyBNC. If this is the first time you have connected to your psyBNC and you followed my guide to this point, you need to set your password. The command to do so is /password pass. When you set your password, you should see a message from -psyBNC confirming your action. You should now edit the server you added to your IRC client, and set the password field. You should still REMEMBER YOUR PASSWORD. If you ever have to set your IRC client up all over again, you won't be able to connect without your password.
Setting up multiple networks on a single process is perhaps the biggest advantage of psyBNC. However, it can also be one of the most frustrating aspects as well. The first step to setting up multiple networks is the /addnetwork command. A word to the wise when adding networks: choose a name consisting of no more than 3 characters. You'll understand why when you see what happens to nicknames and channel names on the secondary network. For example, if you want to add another network that will connect to an EFNet server, I would name the new network "e" or "efn". So the command to add this new network is going to be /addnetwork e. You should see a message from -psyBNC appear confirming that you just created a new network.
The next step is to set your vhost for the new network. Normally, if you want to change your vhost for a single network, you would use the /bvhost vhost command. However, because we're setting our vhost for a secondary network, you need to prefix the vhost with your network name. So in my earlier example I named my new network "e"; so to set my vhost on that new network, I would type /bvhost e'vhost. Again, you should see a message from -psyBNC confirming your setting.
Now we'll add the actual servers for your new network. The command to do this is /addserver server:port. Remember, because we're doing this for a secondary network, we have to prefix the server:port portion with the network name we chose. So following my example, I would type /addserver e'irc.easynews.com:6667. If your new server is going to use SSL, you would type /addserver e'S=server:port . After a few seconds, your psyBNC should attempt to automatically connect to your new network/server.
At this point, I'll explain why I warned you to choose a short network name. Any users or channels on this new network will now be prefixed by the network name you chose. So if I wanted to join #veritynet on my "e" network, I would have to type /join #e'#veritynet for psyBNC to join on the correct network. If I were to leave the "#e'" off the front of the channel name, it would join the channel on my primary network. The same thing applies to other nicknames; to message a user on my "e" network, I would have to type /msg e'user message.
If you find yourself thoroughly confused by multiple networks, join the crowd. Like I said earlier, it's the biggest advantage of psyBNC, but it's also the biggest headache. If you have a spare process available on your shell, you could always run a second psyBNC for your other network.