Hacking

You can override many default values and options by providing them to the JVM. To do so, you have to use the -D parameter in this way

./start -DBAASBOX_PARAMETER=NEW_VALUE

Where BAASBOX_PARAMETER is the key of the parameter to override and NEW_VALUE is the value you want to use. Please note that there is no space between the D and the name parameter. Overridable keys are:

Regarding the config.file key, a possible example of an external configuration file may be:

include classpath("application.conf")
application.code="1234-56789"
orient.baasbox.path=db/baasbox
logger.application=DEBUG

The Play! Framework

BaasBox is built on top of Play! Framework. Because of this you have to download a JDK 6 or above N.B.(JDK not JRE!) and Play! 2.1.1 at this link, and install them following their installation guides. You must also download the BaasBox source code source from its GitHub Repo. Once all the required software is correctly installed, and the BaasBox source code is in a convenient directory, go to that directory and type play dist

After a while, Play! ends to build the application and a new ./dist directory is created in the unzipped BaasBox source code path. In the new ./dist directory you will find a zip file containing the compiled code. To test it, unzip it in any directory and type ./start (remember to set the execution flag). If you are using a Windows system, you need a .bat file. Just create a new start.bat file and place the following line in it:

java %1 -cp “./lib/\*;”
play.core.server.NettyServer.

(Pay attention to the final dot)

Since BaasBox is based upon the Play! Framework 2.1, many configuration options available by Play! could be used with BaasBox. Please refer to the Play! documentation to know how to perform such operations and to customize the default behavior.