Installation

Make sure you’ve installed the App Engine SDK. On Windows simply use the default installation path. On Linux you can put it in /usr/local/google_appengine. On MacOS it should work if you put it in your Applications folder. Alternatively, on all systems you can add the google_appengine folder to your PATH (not PYTHONPATH) environment variable.

Note

Since Google App Engine runs your Python code from within a sandbox, some standard Python installation methods are unavailable. For example, you cannot install django or other Python modules in your system’s Python library. All code for your app must be installed in your project directory.

Create a new directory for your project.

Download the following zip files:

• django-nonrel
• djangoappengine
• djangotoolbox
• django-autoload
• django-dbindexer

Unzip everything and copy the modules into your project directory.

Now you need to create a django project. Djangoappengine includes a project template which you can generate using the django-admin.py command. Run this command from within your project directory to create a new project:

PYTHONPATH=. python django/bin/django-admin.py startproject \
   --name=app.yaml --template=djangoappengine/conf/project_template myapp .

That’s it. Your project structure should look like this:

• <project>/autoload
• <project>/dbindexer
• <project>/django
• <project>/djangoappengine
• <project>/djangotoolbox

To start the local dev server, run this command:

./manage.py runserver

Note

You can also clone the Git repositories and copy the modules from there into your project. The repositories are available here: django-nonrel, djangoappengine, djangotoolbox, django-autoload, django-dbindexer. Alternatively, you can of course clone the respective repositories and create symbolic links instead of copying the folders to your project. That might be easier if you have a lot of projects and don’t want to update each one manually.