Project

General

Profile

QuasselWiki » History » Version 13

sph, 01/17/2009 03:02 AM

1 5 sph
h1. Quassel
2 1 seezer
3 12 sph
{{toc}}
4 12 sph
5 12 sph
6 12 sph
7 5 sph
h2. Introduction
8 5 sph
9 9 sph
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".
10 5 sph
11 5 sph
Quassel's distributed approach:
12 5 sph
!http://lithitux.org/~sphilips/quassel/wiki/distributed.png!
13 5 sph
14 5 sph
15 12 sph
16 7 sph
h2. Getting started
17 7 sph
18 10 sph
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.
19 7 sph
20 12 sph
21 10 sph
h3. Installation
22 10 sph
23 10 sph
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. 
24 10 sph
25 12 sph
26 10 sph
h3. Connecting to the core
27 1 seezer
28 13 sph
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:
29 13 sph
<pre>"openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.quassel/quasselCert.pem -out ~/.quassel/quasselCert.pem"</pre>
30 13 sph
31 13 sph
Now start the core and open quasselclient on your local machine. 
32 1 seezer
33 12 sph
34 12 sph
35 12 sph
36 12 sph
h3. Configuration
37 12 sph
38 12 sph
39 12 sph
40 12 sph
h2. Howto's
41 5 sph
42 4 pennywise
* [[Manage core users]]
43 4 pennywise
* [[Add SSL to the core]]