= Installation Guidelines: Windows - Developer (Installer) =
[[TOC]]

If you are a Developer running Windows and wishing to install Python & all dependent libraries manually then this is the right page for you.

This installer allows for quick installation of Python and all required dependencies required.

It is designed for use by Developers.
 * http://eden.sahanafoundation.org/Eden-Python-Installer-Dev.exe (143Mb)

Includes everything you need to start working with (and on) Eden:
 * Python-2.7.5.msi
 * lxml-2.3.win32-py2.7.exe
 * Shapely-1.2.18.win32-py2.7.exe
 * pywin32-218.win32-py2.7.exe
 * xlrd-0.7.9.win32.exe
 * xlwt-0.7.3.win32.exe
 * PIL-1.1.7.win32-py2.7.exe
 * reportlab-2.7.win32-py2.7.exe
 * pyserial-2.5.win32.exe
 * ipython-0.13.1.py2-win32-PROPER.exe
 * pyreadline-1.7.1.win32.exe
 * dateutil-1.5.tar.gz
 * tweepy-2.1.tar.gz
 * tweepy-2.1.tar.gz
 * web2py 2.7.4 (2013-10-23 20:13:43)
 * eden (2013-10-24 16:10:52)

=== Start Eden ===
Once you've run the installer, and you just want to try your installation of Eden, without Eclipse, you can start web2py from the command line:
{{{
cd C:\Path\To\Installation\web2py
C:\Python27\python.exe web2py.py
}}}
N.B: Obviously replace Python27 with your own version of Python.

Or if you prefer, you can start it from the GUI (Graphical User Interface):[[BR]]
Click Start > My Computer.[[BR]]
Browse to the directory with "web2py.py" and the Eden program inside.[[BR]]
Double click the web2py.py file - this should start up web2py, which will look something similar to this:

[[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/InstallationGuidelines/Windows/Developer/Installer/web2py_1.jpg)]]

Enter a one time admin password and hit "start server".
Then you can go open http://127.0.0.1:8000/eden in your internet browser to run Sahana Eden.

=== Getting the latest revision ===
 Note: This will reuse any pre-installed Python-2.7 environment.[[BR]]
 Note: You do not need to do this if you used the installer.exe file unless you wish to update your eden version to the latest change.
1. Sign-up for an account on [https://github.com GitHub]
1. Set up git on you your computer by following [[http://help.github.com/set-up-git-redirect|these instructions]].[[BR]]
1. Update your local repository from your new fork on Github:
{{{
cd web2py\applications\eden
git pull
}}}
=== Set Your Repository to be able Contribute ===
1. '''Contributor (!Read/Write):''' You need to clone !GitHub repositories using SSH to allow you to {{{push}}} your changes back to !GitHub to contribute to the Sahana Eden project. To do this follow the [[https://help.github.com/articles/generating-ssh-keys| Generatin SSH Keys]] [[BR]]
1. Fork the Sahana Eden Trunk repository at: https://github.com/flavour/eden/fork to get your own copy of the Eden repository (repo) on both !GitHub 
1. Modify the origin repository for this version so that you can {{{push}}} back to your local repository:
{{{
git remote set-url origin git@github.com:GITHUB_USERNAME/eden.git
}}}
1. Add Sahana Eden Trunk as a {{{remote}}} "upstream" repository so that you can pull updates from it:
{{{
git remote add upstream git://github.com/flavour/eden.git
}}}
1. Test that you can {{{push}}} code back to your "origin" !GitHub repository:
{{{
git push
}}}
1. Update your configuration file. (This is something you may need to check when you update your copy of Eden from Github.)
 1. Delete models\0000_update_check.py
 1. Rename models\000_config.py to something else.
 1. Start Eden as above -- you'll get a message saying a new 000_config.py was copied in.
 1. Edit that file. Compare with your saved old copy of 000_config.py and make any changes you need in the new one.
 1. These might include:
 1. Delete the FINISHED_EDITING_CONFIG_FILE line.
 1. Set the database type and connection info.
 1. Set up a mailer.
 1. Choose the template and prepopulate folders.

=== Next: ===

=== Install Eclipse ===
If you want a graphical debugger and full-featured IDE to set breakpoints & step through code then it is recommended to install Eclipse:
 * DeveloperGuidelines/Eclipse

=== Developer Guidelines ===
Now, see how to put your installation to work:
 * DeveloperGuidelines

== Maintenance ==
 * [InstallationGuidelines/Windows/Developer/Installer/Maintenance Maintenance Docs]