Ruben de Laat edited this page Jul 13, 2016 · 15 revisions
Clone this wiki locally

Last updated for Eclipse Mars and BIMserver 1.5

We use Eclipse to develop BIMserver. Other IDE's should work as well, but this page describes how to get started with Eclipse.

It's best to download the "Eclipse Modeling Tools" package, but if you are not going to change the EMF model, you can also just download the "Standard" package, or use your own existing installation.


All BIMserver project are on GitHub. Eclipse should have a Git client already.

Add Repository

  • Fill in your GitHub credentials if you have them (only required if you are planning to, and have the rights to commit).


  • Next


  • Finish (Select the "Import all existing projects after clone finishes" checkbox)


  • Switch back to the Java perspective

Running BIMserver from Eclipse

To run the BIMserver from eclipse, right click the BimServerJar project, select "Run As" and then "Java Application", eclipse will look for classes with main methods, you have to select "LocalDevBimServerStarter", which is in the package "org.bimserver".

Not enough memory

When Java complains there is not enough memory, you can increase the amount of heap memory the BIMserver can use in the "Run configuration". Please read these notes on memory in general. Go to the tab "Arguments" and add the following to the "VM arguments": "-Xmx4g" (this is for 4GB of heap).

Credentials Credentials

Make sure you are running a 64bit JVM when assigning more than 1300MB of heap!

Adding the plugins property

Before BIMserver 1.3 you had to manually edit some source code ( to add the locations of your own plugins to run them. Now you can edit the Eclipse run configuration. The reason behind this is that people don't accidentally check-in the LocalDevPluginLoader file, and to make things configurable without source-code-modification.

You can add as many "plugins" parameters. So for example:

-plugins "C:\Users\My Name\Plugins" -plugins "/home/myname/bimserverplugins"

The directories will be scanned 2 levels deep. So you can for example add your complete GIT directory and it will use all plugins of all workspaces in that directory.



For local development, the BIMserver will be automatically setup. An administrator user with the username "" will be created with the password "admin".

All of the API's are provided at http://localhost:8080, as well as a basic user interface. The admin interface is available at http://localhost:8080/admin.

You now have a working Eclipse environment, we look forward to your pull requests!