This document describes how to install Serendipity blogging software on an Elemental Linux Server (ELS) system.
These instructions assume that you have a working PHP-enabled web server and a working email system. If you do not, see the ELS Howto: Apache and PHP and the ELS Howto: Remote Mail before beginning this document.
You may also want to install the imagemagick package from the 'Additional Applications' CD-ROM.
Installation of Serendipity is well documented. This document will guide you through the specifics of installing it with the SQLite3 database bundled with ELS.
The following example shows how you would install serendipity if your web server document root were /home/httpd and your SQLite databases were stored in /home/sqlite.
cd /home/httpd wget http://prdownloads.sourceforge.net/php-blog/serendipity-1.6.2.tar.gz tar --no-same-owner -zxf serendipity-1.6.2.tar.gz ln -s serendipity blog mkdir /home/sqlite chown daemon /home/sqlite
Configuration of Serendipity is done through a web browser interface and is most easily performed from a client workstation with a graphical browser.
The following example shows the Database Settings fields of the installer for a blog located in /home/httpd/blog and a database stored in /home/SQLite:
Database type: PDO::SQLite Database host: leave blank Database user: leave blank Database password: leave blank Database name: ../../sqlite/serendipity
After completing the simple configuration, you should log into your blog's administration interface and make a few minor changes. Specifically you'll want to do the following:
Testing of the configuration is done as you follow the web-based install procedure and possible remedies to common errors are displayed in the browser. However there are a few things that can be checked if you cannot access the Serendipity configuration page.
For additional help with installation and configuration, please refer to the Serendipity home page.