QuasselWiki » History » Version 14
Version 13 (sph, 01/17/2009 03:02 AM) → Version 14/217 (sph, 01/17/2009 04:26 AM)
h1. Quassel
{{toc}}
h2. Introduction
Quassel is a program to connect to an IRC network. It has the unique ability to split the graphical component (quasselclient) from the core which handles the IRC connection (quasselcore). This means that you can have a core permanently connected to one or more IRC networks and attach a client from wherever you are without moving around any information or settings. However, Quassel can easily behave like any other client, which is referred to as "Quassel Mono".
Quassel's distributed approach:
!http://lithitux.org/~sphilips/quassel/wiki/distributed.png!
h2. Getting started
Setting up Quassel is fairly easy and straightforward. Since we have a separated core and client, we will configure them in two steps. If you are using the Quassel Mono version, then you can skip the core part as this is done internally.
h3. Installation
The best and most reliable way is to simply install the packages provided by your distribution. However, we do offer some static binaries at http://quassel-irc.org/downloads along with Git instructions for those who prefer to compile Quassel themselves.
h3. Connecting to the core
If you wish to setup the core with SSL support, you must have Qt SSL support and a core compiled with the "-DWITH_OPENSSL=ON" cmake option. Generate a key with the following command on the server running the core:
<pre>openssl <pre>"openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.quassel/quasselCert.pem -out ~/.quassel/quasselCert.pem</pre>
Note that the "~/.quassel/" directory may differ if the --datadir option was specified for quasselcore. ~/.quassel/quasselCert.pem"</pre>
Now start the core and launch open quasselclient on your local machine. A connection dialog will show up. Enter the IP address or hostname of the server running the core, enter the port number used by the core and select SSL if applicable. You can also specify a proxy but note that domain names will still be resolved locally (see "Qt4.4":http://doc.trolltech.com/4.4/qnetworkproxy.html#socks5).
During the first connection, you will be guided through a graphical wizard to configure the core properly. Enter a username and password, this will be the administrator. Next, select a database backend (for now this is SQLite only). Click finish and you're done!
h3. Configuration
h2. Howto's
* [[Manage core users]]
* [[Add SSL to the core]]
{{toc}}
h2. Introduction
Quassel is a program to connect to an IRC network. It has the unique ability to split the graphical component (quasselclient) from the core which handles the IRC connection (quasselcore). This means that you can have a core permanently connected to one or more IRC networks and attach a client from wherever you are without moving around any information or settings. However, Quassel can easily behave like any other client, which is referred to as "Quassel Mono".
Quassel's distributed approach:
!http://lithitux.org/~sphilips/quassel/wiki/distributed.png!
h2. Getting started
Setting up Quassel is fairly easy and straightforward. Since we have a separated core and client, we will configure them in two steps. If you are using the Quassel Mono version, then you can skip the core part as this is done internally.
h3. Installation
The best and most reliable way is to simply install the packages provided by your distribution. However, we do offer some static binaries at http://quassel-irc.org/downloads along with Git instructions for those who prefer to compile Quassel themselves.
h3. Connecting to the core
If you wish to setup the core with SSL support, you must have Qt SSL support and a core compiled with the "-DWITH_OPENSSL=ON" cmake option. Generate a key with the following command on the server running the core:
<pre>openssl <pre>"openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.quassel/quasselCert.pem -out ~/.quassel/quasselCert.pem</pre>
Note that the "~/.quassel/" directory may differ if the --datadir option was specified for quasselcore. ~/.quassel/quasselCert.pem"</pre>
Now start the core and launch open quasselclient on your local machine. A connection dialog will show up. Enter the IP address or hostname of the server running the core, enter the port number used by the core and select SSL if applicable. You can also specify a proxy but note that domain names will still be resolved locally (see "Qt4.4":http://doc.trolltech.com/4.4/qnetworkproxy.html#socks5).
During the first connection, you will be guided through a graphical wizard to configure the core properly. Enter a username and password, this will be the administrator. Next, select a database backend (for now this is SQLite only). Click finish and you're done!
h3. Configuration
h2. Howto's
* [[Manage core users]]
* [[Add SSL to the core]]