Enable Apache2 rewrite module ============================= The multisite fonction in this package relies on the Apache2 rewrite module. e.g.: a2enmod rewrite Needed steps to handle a SPIP instance ====================================== To configure a SPIP website you should: * point the required http address to /usr/share/spip in your web server; e.g.: cp /usr/share/doc/spip/apache2.conf /etc/apache2/sites-available/http-host.conf edit /etc/apache2/sites-available/http-host.conf to fit your needs a2ensite http-host * use this command: spip_add_site http-host; This will register a SPIP instance for this host. You can add more in /etc/spip/sites/http-host.php (see below). * make sure to have access to a database; e.g.: CREATE DATABASE http-host character; CREATE user 'http-host'@'localhost' IDENTIFIED BY 'a_password_you_should_change'; GRANT ALL privileges ON http-host.* TO 'http-host'@'localhost'; * visit and complete the installation. About /etc/spip/sites/http-host.php format ========================================== The correspondence between the various site files and the HTTP request is made using $GLOBALS['spip_sites'][$site], where $site is the directory of the site's files (/var/lib/spip/sites/$site). You can use regular expressions. For instance: $GLOBALS['spip_sites']['foo'] = array('foo.example.com\/spip_[^\/]+\/.*'); Will match requests of the form: "http://foo.example.com/spip_bar/whatever" Global configuration ==================== There is an Apache configuration file at /etc/apache2/conf-available/spip.conf, included by default in the webserver configuration.