After installing Python:
[[TOC]]

== Install Web2Py ==
{{{
git clone https://github.com/web2py/web2py.git --recursive
}}}

Sahana now supports the web2py-2.21.2 stable releases, so you should:

{{{
cd web2py
# Reset to web2py-2.21.2
git reset --hard 31905858b
git submodule update
}}}
== Install Eden ==

=== Quick ===

If you are deploying Sahana Eden code base but do not intend on contributing any changes back to the core trunk (perhaps for a custom deployment) you can just clone the Trunk version of Eden:

{{{
cd web2py/applications
git clone https://github.com/sahana/eden.git
}}}

,,'''Note''': the fact that we ensure that the name of the web2py application has no hyphen in, as otherwise it cannot run under Apache!
=== For Ongoing Development ===

If you intend to develop for Sahana Eden and have your code pulled into Trunk you need to follow the instructions [DeveloperGuidelines/Git#ForkYourOwnSahanaEdenRepository Fork Your Own Sahana Eden Repository] to be able to {{{pull}}} new updates and {{{push}}} changes.

==== Mac Users Note ====

To avoid an issue that you may encounter with ongoing coding which is explained in this [http://stackoverflow.com/questions/17829537/git-says-that-some-of-my-image-files-are-untracked-they-are-not stackoverflow.com thread], before running the command to clone the repo, make sure to run:
{{{
git config --global core.precomposeunicode true
}}}
== Start Eden ==
To test your installation of Eden, without Eclipse, you can start web2py from the command line:
{{{
cd .. # the web2py main directory
python web2py.py
}}}

When you first start Eden, then the settings file {{{web2py/application/eden/models/000_config.py}}} will be created from {{{web2py/application/eden/modules/templates/000_config.py}}}.
You will be unable to proceed until you edit this file. The minimal required change is to delete the line with {{{FINISHED_EDITING_CONFIG_FILE = False}}}.


If you want the Scheduler to run, then you'll need to start this separately: UserGuidelines/Scheduler

== Test Eden ==

Once you have web2py running navigate to the server ( http://localhost:8000 by default ). From the web2py drop down menu navigate to "My Sites" and Select Eden. You should now be at the Eden homepage.

By default the 1st user to register will gain the Administrator role. 
== Install Eclipse ==
If you want a graphical debugger to set breakpoints & step through code then it is recommended to install Eclipse:
 * DeveloperGuidelines/Eclipse

== Developer Guidelines ==
Here are some [DeveloperGuidelines/Basics Basic Developers Guidelines] to help get you started. To see how to put your installation to work see DeveloperGuidelines