summaryrefslogtreecommitdiffstats
path: root/docs/INSTALL
blob: 9b66e3fddf32352d853ffede77f007de4f6290a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
*** Quick install instructions (tested on Debian/Ubuntu only!) ***

While "configure" and "make" may be run as normal user all other commands
need to be run as root.

Configure the build system:
	$ ./configure --sysconfdir=/etc --localstatedir=/var

Some configure options available:

    --disable-gtk            disable GTK+ tools                (default: enabled)
    --disable-dbus           disable DBUS support              (default: enabled)
    --disable-python         disable building python modules   (default: enabled)
    --with-dbus-sys=<dir>    where D-BUS system.d directory is
    --with-distro=<distro>   the target Linux distribution (one of redhat,
                                    suse, gentoo, debian or slackware)
    --with-avahi-user=<user> User for running the Avahi daemon (avahi)
    --with-avahi-group=<grp> Group for Avahi (avahi)

    Please note that by disabling DBUS you lose the ability to publish and browse
    services from local applications.

    Please note that only the Debian init script is currently up-to-date. 
    YMMV on other distributions. Patches welcome!

	$ make
	# make install

Add a user an a group for avahi. (Debian specific)
	# addgroup --system avahi
	# adduser --system --no-create-home --ingroup avahi avahi

Ask DBUS to re-read its policies:
	# kill -HUP `cat /var/run/dbus/pid`

Now start the Avahi daemon:
	# /etc/init.d/avahi-daemon start

Optionally start the unicast DNS configuration daemon:
	# /etc/init.d/avahi-dnsconfd start

To start the two daemons at boot time on Debian based distributions:
	avahi-daemon without DBUS support:
	# update-rc.d avahi-daemon defaults 25 15
	avahi-daemon with DBUS support:
	# ln -s /etc/init.d/avahi-daemon /etc/dbus/event.d/75avahi-daemon

	avahi-dnsconfd:
	# update-rc.d avahi-dnsconfd defaults 26 14

$Id$