source: doc/user-guide/Installation.xml @ b17fa67

Last change on this file since b17fa67 was 7ec2ce8, checked in by dequis <dx@…>, at 2018-01-10T03:05:23Z

Remove MSN. Use the skypeweb purple plugin instead.

RIP

As per http://ismsndeadyet.com/ all versions up to MSNP22 died a few
months ago. We had a MSNP21 implementation, bought us two extra years.

Implementing MSNP24 is technically possible but also pointless given
skypeweb, and the authentication requires some fairly messed up crypto
and legacy old-skype-protocol servers. For a long time I tried to
reverse a potentially simpler method, and got fairly close, but never
completed that. I haven't done any attempts to continue it in the last
year, so I'm fine with giving up at this point.

  • Property mode set to 100644
File size: 4.5 KB
Line 
1<chapter id="Installation">
2
3<title>Installation</title>
4
5<sect1>
6<title>Downloading the package</title>
7
8<para>
9The latest BitlBee release is always available from <ulink
10url="http://www.bitlbee.org/">http://www.bitlbee.org/</ulink>.
11Download the package with your favorite program and unpack it: <command>tar
12xvfz bitlbee-&lt;version&gt;.tar.gz</command> where &lt;version&gt; is to be
13replaced by the version number of the BitlBee you downloaded (e.g. 0.91).
14</para>
15
16</sect1>
17
18<sect1>
19<title>Compiling</title>
20<para>
21BitlBee's build system has to be configured before compiling. The
22<filename>configure</filename> script will do this for you. Just run
23it, it'll set up with nice and hopefully well-working defaults. If you
24want to change some settings, just try
25<command>./configure --help</command> and see what you can do.
26</para>
27
28<para>Some variables that might be of interest to the normal user:</para>
29
30<itemizedlist>
31<listitem><para>prefix, bindir, etcdir, mandir, datadir - The place where
32all the BitlBee program files will be put. There's usually no reason to
33specify them all separately, just specifying prefix (or keeping the default
34<filename>/usr/local/</filename>) should be okay.</para></listitem>
35<listitem><para>config - The place where BitlBee will save all the per-user
36settings and buddy information. <filename>/var/lib/bitlbee/</filename>
37is the default value.</para></listitem>
38<listitem><para>jabber, oscar, twitter - By default, support for all
39these IM-protocols (OSCAR is the protocol used by both ICQ and AIM) will
40be compiled in. To make the binary a bit smaller, you can use these options
41to leave out support for protocols you're not planning to use.</para></listitem>
42<listitem><para>debug - Generate an unoptimized binary with debugging symbols,
43mainly useful if you want to do some debugging or help us to track down a
44problem.</para></listitem>
45<listitem><para>strip - By default, unnecessary parts of the generated binary
46will be stripped out to make it as small as possible. If you don't want this
47(because it might cause problems on some platforms), set this to 0.
48</para></listitem>
49<listitem><para>flood - To secure your BitlBee server against flooding attacks,
50you can use this option. It's not compiled in by default because it needs
51more testing first.</para></listitem>
52<listitem><para>ssl - BitlBee can use three different SSL libraries: GnuTLS,
53mozilla-nss and OpenSSL. (OpenSSL is, however, a bit troublesome because of
54licensing issues, so don't forget to read the information configure will
55give you when you try to use OpenSSL!) By default, configure will try to
56detect GnuTLS or mozilla-nss. If none of them can be found, it'll give up.
57If you want BitlBee to use OpenSSL, you have to explicitly specify that.
58</para></listitem>
59</itemizedlist>
60
61<para>
62After running <filename>configure</filename>, you should run
63<command>make</command>. After that, run <command>make install</command> as
64root.
65</para>
66
67</sect1>
68
69<sect1>
70<title>Configuration</title>
71
72<para>
73By default, BitlBee runs as the user nobody. You might want
74to run it as a separate user (some computers run named or apache as nobody).
75</para>
76
77<para>
78Since BitlBee uses inetd, you should add the following line to <filename>/etc/inetd.conf</filename>:
79</para>
80
81<para>
82<programlisting>
836667    stream  tcp     nowait nobody /usr/local/sbin/bitlbee bitlbee
84</programlisting>
85</para>
86
87<para>
88Inetd has to be restarted after changing the configuration. Either
89<command>killall -HUP inetd</command> or
90<command>/etc/init.d/inetd restart</command> should do the job on most systems.
91</para>
92
93<para>
94You might be one of the.. ehr, lucky people running an xinetd-powered distro.
95<command>xinetd</command> is quite different and they seem to be proud of that.. ;-)
96Anyway, if you want BitlBee to work with <command>xinetd</command>, just copy the
97bitlbee.xinetd file to your /etc/xinetd.d/ directory (and probably edit it to suit
98your needs).
99</para>
100
101<para>
102You should create a directory where BitlBee can store it's data files. This
103should be the directory named after the value 'CONFIG' in Makefile.settings.
104The default is <filename>/var/lib/bitlbee</filename>, which can be created
105with the command <command>mkdir -p /var/lib/bitlbee</command>. This
106directory has to be owned by the user that runs bitlbee. To make
107'nobody' owner of this directory, run <command>chown nobody /var/lib/bitlbee</command>.
108Because things like passwords are saved in this directory, it's probably
109a good idea to make this directory owner-read-/writable only.
110</para>
111</sect1>
112
113</chapter>
Note: See TracBrowser for help on using the repository browser.