This document is an older, unmaintained guide. There may be a new guide available for this software.
FlatPress is a web application for managing and publishing blogs. Modeled on other popular content management systems for blogging, FlatPress uses a file-based system for storing content and does not require any kind of database system. FlatPress provides advanced features, and depending on the specific needs of your project, FlatPress may support higher load. Additionally, FlatPress provides a fully featured template engine and plugin framework for user-generated plug-ins.
This guide assumes that you have completed the appropriate Apache Web server installation guide for your operating system but you may choose an alternate web server such as nginx to provide access to your FlatPress powered site.
If you're running Debian or Ubuntu systems, ensure that your system's package repository is up to date, that all installed packages have been upgraded with the latest bug fixes and security patches using the following command sequence:
apt-get update apt-get upgrade apt-get install apache2 php5 php-pear php5-suhosin bzip2
On CentOS and Fedora systems issue the following commands to ensure your system's packages are up to date, that all required packages are installed, and that the web server is running and will restart following future boots:
yum update yum install httpd php php-pear bzip2 /etc/init.d/httpd start chkconfig --levels 235 httpd on
For the purpose of this guide we will assume that you have virtual hosting configured for the domain ducklington.org with all publicly accessible resources located in the document root /srv/www/ducklington.org/public_html/. In this document you will install FlatPress into this document root. Modify all of the instructions below to agree with the architecture of your deployment.
This document contains specific instructions for installing version 0.909.1 of FlatPress. Please check the upstream source to confirm that this is the most up to date version of the software and that there are no vulnerabilities or bugs. Issue the following sequence of commands to download, extract, move the FlatPress files to your web server's document root, and properly configure file permissions:
mkdir -p /srv/www/ducklington.org/src/ cd /srv/www/ducklington.org/src/ wget http://downloads.sourceforge.net/project/flatpress/flatpress-0.909.1-arioso.tar.bz2 tar -xjf flatpress-0.909.1-arioso.tar.bz2 mv flatpress flatpress-0.909.1 cp -R flatpress-0.909.1/* /srv/www/ducklington.org/public_html/ chmod 777 /srv/www/ducklington.org/public_html/fp-content/
Now visit http://ducklington.org/setup.php in your web browser and follow the setup procedure provided by the FlatPress web based interface. When the setup process has completed, issue the following commands to remove the setup files:
rm /srv/www/ducklington.org/public_html/setup.php rm -rf /srv/www/ducklington.org/public_html/setup/
Congratulations! You have now successfully deployed FlatPress.
When running software compiled or installed directly from sources provided by upstream developers, you are responsible for monitoring updates, bug fixes, and security issues. After becoming aware of releases and potential issues, update your software to resolve flaws and prevent possible system compromise. Monitoring releases and maintaining up to date versions of all software is crucial for the security and integrity of a system.
Please monitor the Flatpress development list to ensure that you are aware of all updates to the software and can upgrade appropriately or apply patches and recompile as needed.
When upstream sources offer new releases, repeat the instructions for installing the Flatpress software as needed. These practices are crucial for the ongoing security and functioning of your system.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.
Last edited by Sharon Campbell on Wednesday, October 2nd, 2013 (r3765).