Installing GeoNode
==================

The easiest way to install GeoNode is using the official packages for one of the supported Operating Systems.
Please be advised that GeoNode requires at least 4GB of RAM (6GB including swap).

Ubuntu 12.04 
-----------------------------

Open a terminal and run the following commands::

    sudo add-apt-repository ppa:geonode/testing
    sudo apt-get update
    sudo apt-get install geonode


OSX, Windows and other operating systems
----------------------------------------

Our recommendation is to use a Virtual Machine with one of the supported Operating Systems.
If that is not an option then you could try to follow manually the steps of the install script
adjusting for paths and commands in your OS.

Manual installation
-------------------

This is mostly targeted to Linux based distributions,
it has only been tested in Ubuntu Linux but should work with minimal changes to the config file.

# First you need to install the OS specific dependencies,
here is the complete list (the actual package name may vary)::

    geoserver, python3, python3-support, python3-dev, sun-java6-jre | openjdk-6-jre, tomcat6, postgresql-9.3, gcc, patch, zip,  python3-pil, gdal-bin, libgeos-dev, python3-urlgrabber, python3-pastescript, gettext, postgresql-contrib, postgresql-9.3-postgis-2.1,libpq-dev, unzip, libjpeg-dev, libpng-dev, python3-gdal, libproj-dev, python3-psycopg2, apache2, libapache2-mod-wsgi, libxml2-dev, libxslt1-dev

# Then you have to edit the config file that is in the support directory with the appropiate paths,
sample config files for Ubuntu and CentOS are distributed with the release packages.

# After that, open a terminal and run the following command as a super user::

    ./install.sh support/config.sh

# To test your GeoNode installation simply type the following in your terminal::

    geonode help

  You should also navigate to your browser window and type `http://localhost/`

# After you have installing your GeoNode we recommend you to read the following guide to learn how to create users,
serve the site on a DNS or IP address and optimize your GeoNode.
    http://docs.geonode.org/deploy/production.html 

Note for packagers
~~~~~~~~~~~~~~~~~~

There is an advanced flag for the install script called 'step'.
There are two main steps to install GeoNode,
the first one is to place the required files in the right places (referred to as pre-install) and
the other to create the postgis database and edit the required Django and GeoServer config files (referred to as post-install).

By default the install script does both, but usually it is appropriate to perform the first of these steps during package creation and the second one at install time.

The step flag supports three values: 'pre', 'post' and 'all'. Default is 'all'. Here is usage example::

    # in debian/rules#install
    ./install.sh -s pre support/config.sh

    # in debian/postinst
    ./install.sh -s post support/config.sh


GPL License
===========

GeoNode is Copyright 2016 Open Source Geospatial Foundation (OSGeo).

GeoNode is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

GeoNode is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GeoNode.  If not, see <http://www.gnu.org/licenses/>.