|Version 25 (modified by 10 years ago) ( diff ),|
After installing Python:
As a Developer, it is best to run the Trunk version of Web2Py, so that you can fine-tune the version that you have installed & get involved with the Web2Py developer community:
git clone https://github.com/web2py/web2py.git
Note: HTTPS clones are not read-only (while git:// clones are). They will NOT work if your git is not configured as previously described.
There are occasional issues with the latest Trunk, so you may need to try a slightly older revision. If this is needed, after downloading:
cd web2py git log git checkout <hash>
"git log" shows you a log including the hash-value of every revesion. Checkout sets your working-copy to the revision with the specified hash-value.
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/flavour/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!
Mac Users Note
To avoid an issue that you may encounter with ongoing coding
which is explained in the following stackoverflow.com thread,
Before running the above command to clone the repo, make sure to run:
git config --global core.precomposeunicode true
For Ongoing Development
If you intend to develop for Sahana Eden and have your code pulled into Trunk you need to follow the instructions Fork Your Own Sahana Eden Repository to be able to
pull new updates and
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
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
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.
If you want a graphical debugger to set breakpoints & step through code then it is recommended to install Eclipse: