Split off koha-common.
[koha.git] / 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 * Enable the rewrite module for Apache.
17   - sudo a2enmod rewrite
18 * Restart Apache.
19   - sudo service apache2 restart
20
21 Then access the following URL:
22
23     http://localhost:8080/
24
25 Alternatively, any other name, IP address, and interface will work, too.
26
27 This should bring up the Koha intranet administration screen, which will
28 let you log in. The username is koha, the password is in the
29 /etc/koha/koha-config.xml file (search for "pass").