= Installation Guidelines: Linux (Production: Cherokee/PostgreSQL) =
[[TOC]]
Installs that we maintain are usually done using Cherokee & PostgreSQL

 * [wiki:InstallationGuidelines/Cherokee Cherokee] is a high-performance web server with a graphical admin UI
 * [wiki:InstallationGuidelines/PostgreSQL PostgreSQL] is a database with powerful geospatial support

The simplest way to install is using our attached installation scripts.

These assume that you are installing on Debian Stable (8 'Jessie' or the older 7 'Wheezy').
 * Ubuntu will be similar, although you may need to tweak the setup (e.g. different PostgreSQL versions)
 * There are notes on installing on RedHat-based systems here, although these aren't as well-maintained: [wiki:InstallationGuidelines/Linux/Server/RedHat]
 * For postgres-9.3, use [http://initd.org/psycopg/ psycopg2] as the driver instead of the web2py default pg8000.  

This is split into 2 halves, as the 1st script can create a base image which is then customised per-instance using the configure script.

Download & set permissions:
{{{
wget --no-check-certificate https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/install-eden-cherokee-postgis.sh
chmod a+x install-eden-cherokee-postgis.sh
wget --no-check-certificate https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/configure-eden-cherokee-postgis.sh
chmod a+x configure-eden-cherokee-postgis.sh
}}}

Install:
{{{
./install-eden-cherokee-postgis.sh
}}}

Configure:
{{{
./configure-eden-cherokee-postgis.sh
}}}

Note: We install using the latest Trunk version of Eden as there is no Stable release yet. This can occasionally cause teething problems, so you may need to revert back a version or get issues fixed via the mailing list.

== Before Imaging ==
[https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/install-eden-cherokee-postgis.sh install-eden-cherokee-postgis.sh]
[[Include(https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/install-eden-cherokee-postgis.sh, text/plain)]]

== After Imaging ==
[https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/configure-eden-cherokee-postgis.sh configure-eden-cherokee-postgis.sh]
[[Include(https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/configure-eden-cherokee-postgis.sh, text/plain)]]

== Add a Test Site ==
If you wish to add a second site to your system for Test purposes (QA of new code & practising data migrations) then you can use this script:
[https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/add_test_site.sh add_test_site_update.sh]
[[Include(https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/add_test_site.sh, text/plain)]]

== Add a Demo Site ==
If you wish to add a third site to your system for Demo purposes (have dummy data loaded which doesn't require so strict an authentication to read, allow people to add dummy data of their own to practise) then you can use this script (NB assumes that a Test site has already been added):
[https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/add_demo_site.sh add_demo_site.sh]
[[Include(https://raw.githubusercontent.com/sahana/eden_deploy_manual/master/add_demo_site.sh, text/plain)]]

== Next ==
If you wish to update your site from an alternate github repo this can be done using:
* ConfigurationGuidelines#SwitchtoanalternateGitHubrepo

Administration Guide:
* [wiki:UserGuidelines/Admin Administration Guide]