IDempiere Deployment In Eclipse IDE For Linux And Windows Operating System

From iDempiere en

This page can contain obsolete information, please refer to Installing iDempiere

Thanks to initial work done by Red1, this tutorial is brought to you and supported by Ing. Tatioti Mbogning Raoul and Dr.-Ing Stanley Mungwe from IT-Kamer and ERP University Cluster If you need support, have questions, criticism or improvement suggestions, feel free to write us an email

Deployment prerequistes

To easly deploy IDempiere source code, we need :

  • Eclipse Kepler for JEE developers.

You can download this eclipse version at this url : can use other version but it is in your own risks.

  • Postgresql database management

Install Postgresql

  • Windows

To install postgresql on windows simply download the installer at this url :

  • Linux

For Ubuntu, Kubuntu and others debian distributions simply run this command : sudo apt-get install postgresql. You can also go to postgresql web site download section :

Download source code

To download the source code it is preferable to use the bitbucket repository. Bitbucket use the mercurial as project versioning so to clone the project in your machine, you must first install mercurial.

Install mercurial

  • Windows

To install mercurial on windows, you can go at this page : and download the appropriate file for your windows architecture. This package must allow you to use mercurial commands lines on windows.

  • Linux

For debian distribution you can simply run this command : sudo apt-get install mercurial.

After successfully install mercurial, simply use this command to clone the project : hg clone idempiere. This command clone the source code in the folder name idempiere in the current directory.

Setting up eclipse

If you are here is that you have download eclipse kepler and download the idempiere source code. Now follow this step :

  • Copy idempiere source code and paste it in your eclipse workspace. Your eclipse workspace must be like this :

Linux eclipse step0.png

Only Buckminster core, Buckminster maven and Buckminster pde are required.

  • Go to Preferences >> Plug-in Development >> Target Platform >> Add

Follow the steps on the screenshots :

Linux eclipse step1.png

Click on next.

Linux eclipse step2.png

Click on add.

Linux eclipse step3.png

Click on next.

Linux eclipse step4.png

Click on finish.

Linux eclipse step5.png

Click to finish and select the new created IDempiere Target Platform like this :

Linux eclipse step10.png

Now go to file menu and click on Import. You have to look for the item Buckminster in the tree. Expand this item and choose Materialize from Buckminster MSPEC, CQUERY or BOM.

Linux eclipse step6.png

Click on next.

Click on Browse...

Linux eclipse step7.png

Go into your workspace where your extract iDempiere's source code. Open the directory named : org.idempiere.sdk-feature and choose the file adempiere.cquery.

Linux eclipse step8.png

And click to start the process. This will take a while. Please to avoid errors, it is necessary to have a good internet connection.

After that your eclipse should look like this :

Linux eclipse step9.png

Import database

If you are there is that you have install postgresql in your computer machine. To easly import database in postgresql simply use the script in the zip file. To use the python script you must install python and psycopg (postgresql python driver). After download the script you have to go in your workspace : org.adempiere.server-feature >> data >> seed, copy the file named : Adempiere_pg and extract using winrar or winzip in the directory where you unzipped the file SetupPostgreSql below. Rename the file Adempiere.dmp into Adempiere_pg.dmp.

Script : [SetupPostgreSQL]


If python is not yet install for debian distributions use this command : sudo apt-get install python.

To install psycopg simply use this command for debian distributions : sudo apt-get install python-psycopg2.

After that you need to switch to the user postgres : sudo su postgres

Now you can go to the unzip folder and run this command : python and follow the instructions.


Open windows command line, go tho the unzip folder and run the batch program : import_postgresql_database.bat [adempiere role password].

SQL Migration Scripts

After successfully imported the database, you have to process the migration scripts to be able to run iDempiere.

IDempiere Configuration

After import database, it is time to configure idempiere in eclipse. Follow this steps :

  • Lunch eclipse
  • Go to Run >> Run Configurations...

You would have this picture :

Linux eclipse step11.png

Select in eclipse and click to Run at the bottom right. After few seconds you would have idempiere configuration interface show up in your screen. It would look like this :

Linux eclipse step12.png

  • Java Home : Java JDK path
  • IDempiere Home : IDempiere Home. You can left it
  • Application server : localhost
  • Web port : 8080. You can put other value. You must be sure the specified port is open
  • SSL : 8443. Port for SSL connection on idempiere server
  • Database already exist : Check the box because you are succesfully create postgresql database and import data
  • Database server : Put the postgresql server hostname or IP adress
  • Database type : Postgresql
  • Database name : idempiere
  • Database port : Put the postgresql server port
  • Database User : adempiere
  • Database password & Put the password you provided when you created adempiere role in section 4
  • DB Admin password : Put the password for the postgres user of postgresql

After fill the field, click on the test button. Everything must be green except the checkbox for the DB Admin password if you left it empty. Now you can click to Save.

IDempiere server

To start idempiere server, go to Run >> Run Configurations... and run server.product application. The idempiere server must start and after that you can open your prefered browser and open the page : http://localhost:8080/ or host:port using the host and the port you provided in idempiere configuration in section 5. You must see the IDempiere Server web page. Enjoy !!!

IDempiere client

To start idempiere client, go to Run >> Run Configurations... and run swingclient.product application. The idempiere swing client must start and must look like this :

Linux eclipse step13.png

First, click on the server field. It must open this windows :

Linux eclipse step14.png

Fill the fields with the values provided in the section 5. After that, click on Test Database button and validate information. You must be redirect to the login page. You can change language and left User ID and Password. Enjoy !!!!.


Ing. Tatioti Mbogning Raoul(Tatiotir)

Under the direction of

Dr.-Ing Stanley A. Mungwe

IT Kamer Company Ltd, Cameroon

--Tatiotir (talk) 23:01, 5 September 2014 (CEST)

Cookies help us deliver our services. By using our services, you agree to our use of cookies.