]> git.meshlink.io Git - catta/blob - docs/INSTALL
* allow the user to specify a static browse domain list in the configuration file
[catta] / docs / INSTALL
1 *** Quick install instructions (tested on Debian/Ubuntu only!) ***
2
3 While "configure" and "make" may be run as normal user all other commands
4 need to be run as root.
5
6 Configure the build system:
7         $ ./configure --sysconfdir=/etc --localstatedir=/var
8
9 Some configure options available:
10
11     --disable-gtk            disable GTK+ tools                (default: enabled)
12     --disable-dbus           disable DBUS support              (default: enabled)
13     --disable-python         disable building python modules   (default: enabled)
14     --with-dbus-sys=<dir>    where D-BUS system.d directory is
15     --with-distro=<distro>   the target Linux distribution (one of redhat,
16                                     suse, gentoo, debian or slackware)
17     --with-avahi-user=<user> User for running the Avahi daemon (avahi)
18     --with-avahi-group=<grp> Group for Avahi (avahi)
19
20     Please note that by disabling DBUS you lose the ability to publish and browse
21     services from local applications.
22
23     Please note that only the Debian init script is currently up-to-date. 
24     YMMV on other distributions. Patches welcome!
25
26         $ make
27         # make install
28
29 Add a user an a group for avahi. (Debian specific)
30         # addgroup --system avahi
31         # adduser --system --no-create-home --ingroup avahi avahi
32
33 Ask DBUS to re-read its policies:
34         # kill -HUP `cat /var/run/dbus/pid`
35
36 Now start the Avahi daemon:
37         # /etc/init.d/avahi-daemon start
38
39 Optionally start the unicast DNS configuration daemon:
40         # /etc/init.d/avahi-dnsconfd start
41
42 To start the two daemons at boot time on Debian based distributions:
43         with DBUS support:
44         # ln -s /etc/init.d/avahi-daemon /etc/dbus-1/event.d/75avahi-daemon
45         # ln -s /etc/init.d/avahi-dnsconfd /etc/dbus-1/event.d/76avahi-dnsconfd
46
47         without DBUS support:
48         # update-rc.d avahi-daemon defaults 25 15
49         # update-rc.d avahi-dnsconfd defaults 26 14
50
51 $Id$