git.meshlink.io Git - catta/blob - 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 Avahi currently ships with a init scripts for only a few
  24     distributions. if yours is not supported right now, YMMV. Patches welcome.
  25
  26         $ make
  27         # make install
  28         # ldconfig
  29
  30 Add a user an a group for avahi. (Debian specific)
  31         # addgroup --system avahi
  32         # adduser --system --no-create-home --ingroup avahi avahi
  33
  34 Ask DBUS to re-read its policies:
  35         # kill -HUP `cat /var/run/dbus/pid`
  36
  37 Now start the Avahi daemon:
  38         # /etc/init.d/avahi-daemon start
  39
  40 Optionally start the unicast DNS configuration daemon:
  41         # /etc/init.d/avahi-dnsconfd start
  42
  43 To start the two daemons at boot time on Debian based distributions:
  44         with DBUS support:
  45         # ln -s /etc/init.d/avahi-daemon /etc/dbus-1/event.d/75avahi-daemon
  46         # ln -s /etc/init.d/avahi-dnsconfd /etc/dbus-1/event.d/76avahi-dnsconfd
  47
  48         without DBUS support:
  49         # update-rc.d avahi-daemon defaults 25 15
  50         # update-rc.d avahi-dnsconfd defaults 26 14
  51
  52 If you plan to use avahi-autoipd you have to create the user/group
  53 "avahi-autoipd" much the same way as "avahi".
  54
  55 $Id$