Anoxs · IRC

Documentation - ShroudBNC

How to: Compile a ShroudBNC on a Phoenix Shell

First of all, you'll need to login to your shell. I'll assume you know how to do that.

If you want an automated installer, get it here


sh PORT Replace the port with the web access port.


Now that you are logged in, grab the latest version of sbnc at:

So get them using wget:


Listing downloaded files

Now, that you got the files, you should extract them using the tar command:

tar -zxf sbnc-current.tar.gz
tar -zxf sbnc-iface.tar.gz

We will handle the Internet Access [iFace / Webifi] later on.

Listing extracted stuff

Now, to the installing:

cd sbnc-1.1 or whatever version you got.

It will write a lot of nonsense.

Configuring sbnc

Now that this is done, we should install it, so type these:

make install

Installing sbnc

Since we want the web access enabled, we should install tcl support. You'll see a lot of nonsense in the proccess, just like before.

cd tickle
make install

Installing Tickle

Now, we are ready to configure our sBNC and start using it!

cd ~/sbnc [Leads to the place where sbnc was installed without asking you].

sBNC will now as you a few questions, just answer them as you wish:

Port: The port you'll connect to, I used 34543 here.
Name: The name of the BNC user, I used 'bug' here.
Password: Guess....

Configuring sbnc

Before we will run it, we should get the Webifi working for this. You will need to copy the /scripts from the webifi you extracted into your sBNC scripts like this:

cp ~/webifc/scripts/* ~/sbnc/scripts/

Next, you'll need to go to the scripts folder [The one of sbnc] and edit iface.tcl, you can use Vim / Nano. Nano is easyer so I used it to explain, even though I use vim by myself.

nano ~/sbnc/scripts/iface.tcl

Editing iface.tcl

Change the port there to anything you want, it will be used for the internet access communication, remember it for later use. I changed it to 34544.

Editing iface.tcl

One more file to edit, which is: sbc.tcl:

nano ~/sbnc/sbnc.tcl<

Just add in the end of the line this and save:

source "scripts/iface.tcl"

Editing sbnc.tcl

Do Ctrl+X to exit and when it asks if to save say, yes with the same name [Just enter]. Now, we should move the web access folder, to a place it'll be accessable and configure it.

cd ~
mkdir public_html [For making web pages on phoenix].
mv webifc/ public_html/ [Moves the webifc to an accessable place].
cd public_html/webifc/
nano config.php

Editing config.php

Change the port to what you used [I used 34544] and save. After that, go back to your sbnc folder and run sbnc.

cd ~/sbnc

Your SBNC is now running!

Run sbnc

Next, we need to enable your Web Panel, so grab your IRC client [mIRC / xChat / Irssi?] and login to [34543 for me]. With a command like this [Change it to fit you]:

/server 34543 password -i user

It will login and you'll get a private message from your BNC:

<-sBNC> You haven't set a server yet. Use /sbnc set server <Hostname> <Port> to do that now.

Connecting with mIRC

Now you need to configure the server, so use this command [or PM to the sBNC without the /sbnc]:

/sbnc set server 6667 OR /msg -sBNC set server 6667

Make sure to change the vhost you are using to what you want using:


Connecting with mIRC

To enable the Web Panel, you need to load the TCL module like this:

/sbnc insmod ./ / /msg -sBNC insmod ./

You'll get a message saying it was loaded, now just tell it to rehash it's TCL.

/sbnc tcl rehash / /msg -sBNC tcl rehash

Connecting with mIRC

Web access is on. You should now join a channel with the /Join

/join #Phoenix

Connecting with mIRC

You can access your web panel of Webifc at The user and password are any valid user you created, so far only the first one. The panel itself shouldn't be hard to understand.


Minor details: I used the temp account I made bug2000, my account is bug. I don't use these ports, so don't bother to try and crack it. For security, you might want to change the name of the webfic folder. Also, the Webifc DOESN'T have to be on phoenix, you can put it anywhere that support php.

© 2007 Tutorial made by Bug @ Phoenix Network