If you benefit from web2py hope you feel encouraged to pay it forward by contributing back to society in whatever form you choose!

1) Download the latest Eclipse IDE (Galileo at the time of this post) and extract it to the folder of your choice.


2) Start Eclipse by running eclipse.exe in the folder. Note: there is no installation for eclipse but you must have the Java runtime installed.

3) Install PyDev by clicking on Help / Install New Software and entering the following URL then clicking the Add button:


Select all of the options and hit next.

It should prompt you to accept a license agreement. Continue through the wizard and click No when it asks you if you want to restart.

4) Install the correct mercurial version for your operating system. Next install MercurialEclipse. It adds mercurial support directly to Eclipse. Go back to Help / Install New Software and enter the url:


Continue through the wizard and click Yes when it asks you to restart this time.

5) Create a new project in Eclipse by going to File / New / Project / Mercurial / Clone Repository using Mercurial and enter the url:


Enter 'web2py' in the Clone Directory Name field.

6) Set the interpreter by going to Window / Preferences / PyDev / Interpreter and choosing the path to your Python binary.

7) That's it!. You can start debugging by finding web2py.py in the project tree, right clicking, and selecting Debug As / Python Run. You can also pass arguments to web2py.py by choosing Debug Configuration from the same menu.

Related slices

Comments (6)

  • Login to post

  • 0
    joe-codeswell 8 years ago

    Thanks, Mr Freeze. GREAT guide.

    However, I am +1 for Jonathan Bejarano's comment on the URL:

    No Good    http://code.google.com/p/web2py/source/checkout     #Doesn't work
    GOOD:      https://code.google.com/p/web2py/
    Thanks again.

    Love and peace,



  • 0
    jonathan-bejarano-10680 9 years ago

    I noticed that URL should be: https://code.google.com/p/web2py/

    for the mecurial address

  • 0
    mrfreeze 11 years ago
    Awesome guide here

  • 0
    richard 11 years ago
    I think these instructions may be out of date. I tried installing the latest Eclipse/Mercurial/PyDev stuff and thus far, no go -- and Mr. Freeze's generous description above didn't match my screens. It would be great if he could update this slice. Peace.

  • 0
    mrfreeze 12 years ago
    web2py now uses mercurial for source control. Install MercurialEclipse instead of SubClipse.
show more comments

Hosting graciously provided by:
Python Anywhere