debian/koha.README.Debian

   1 koha packaged for Debian
   2 ========================
   3
   4 When you install the koha.deb package, it does not quite work out of the
   5 box. Due to various limitations imposed by sanity and the Debian packaging
   6 policies, it is not yet possible to make it so without excessive work.
   7 The work will happen later. For now, you get a checklist.
   8
   9 To enable Koha on your machine, after installing this package, do the
  10 following:
  11
  12 * Make XML::LibXML::SAX:Parser the default parser for Perl's XML SAX
  13   implementation.
  14   - edit /etc/perl/XML/SAX/ParserDetails.ini to
  15     move XML::LibXML::SAX:Parser section last in the file
  16   - FIXME: This should become unnecessary: Koha is in the process of
  17     being patched to specify the parser it needs explicitly, instead
  18     of assuming it is the default one.
  19 * Enable the suexec module for Apache.
  20   - sudo a2enmod suexec
  21 * Enable the rewrite module for Apache.
  22   - sudo a2enmod rewrite
  23 * Restart Apache.
  24   - sudo service apache2 restart
  25
  26 The latter two steps can be done by running the koha-post-install-setup
  27 script.
  28
  29 Then access the following URL:
  30
  31     http://localhost:8080/
  32
  33 Alternatively, any other name, IP address, and interface will work, too.
  34
  35 This should bring up the Koha intranet administration screen, which will
  36 let you log in. The username is koha, the password is in the
  37 /etc/koha/koha-config.xml file (search for "pass").