To download CapeDwarf, go to Downloads. Currently, you may choose to download CapeDwarf on JBossAS7 (CapeDwarf version 1.x) or on the newer WildFly Application Server (CapeDwarf version 2.x). Unzip the downloaded zip file to a location of your choosing (in order to avoid bugs it’s always good practice to install into a directory path that does not include spaces or special characters).

Let’s refer to the folder you unziped CapeDwarf into as %CAPEDWARF_HOME%.

Assuming you already have an existing GAE application, you probably have the whole application in a directory somewhere on your hard drive. The easiest way of deploying the app is by running %CAPEDWARF_HOME%/bin/capedwarf.sh <location of app>.

Let’s say your application is located at /home/me/my_gae_app/war/ and you’ve installed CapeDwarf into /home/me/capedwarf/, you run the app on CapeDwarf with the following command:

CapeDwarf should start up and print a bunch of lines to the console. The last line should look something like this:

Your app is now deployed and should be available at http://localhost:8080. The admin console is available at http://localhost:8080/_ah/admin - same as on Google App Engine.

Certain GAE service APIs, like the Mail Service API, XMPP Service API, need to be manually configured in order to function properly on CapeDwarf. Please refer to the User Guide for more information.