Installazione iDempiere


Installazione Sviluppo Linux

The examples on this guide are using the following versions:

  • Ubuntu 14.04.2 64 bits
  • PostgreSQL 9.4.1 (it's also tested and working with version 8.4.22)
  • PostgreSQL contrib (for UUID support)
  • Mercurial Client 2.8.2
  • OpenJDK 1.7.0_75 (for version 2.1 it requires it works with 1.6.0_34)
  • Eclipse IDE for Java EE Developers 4.4.1 Luna (for version 2.1 it requires 3.7.2 Indigo)
  • Mercurial Eclipse Plugin 2.0.0 (for Indigo it's tested with 1.9.1)
  • Buckminster 4.4 (for Indigo it's tested with 3.7)


But this guide can be used in other systems (even Windows) taking care of installing the corresponding packages and using corresponding commands.

Install Ubuntu

Please refer to

Install Postgresql 9.4.1

iDempiere can also run with Oracle 10G or 11G, and also with PostgreSQL 8.4 to 9.3, but for this tutorial we use postgresql 9.4.1 - see for details

echo "deb trusty-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - | sudo apt-key add -
sudo apt-get update
sudo apt-get install postgresql-9.4
sudo apt-get install postgresql-contrib
Assign a password to user postgres

In order to create the database the installer needs to know the password of user postgres, by default this user doesn't have a password in ubuntu (windows installer asks for a password).

Please take note of the password you assign here as it will be required in the setup process:

Steps are (replace your_chosen_password by your preferred):

sudo su - postgres
psql -U postgres -c "alter user postgres unencrypted password 'your_chosen_password'"

Dopo aver installato postgres è necessario verificare la corretta configurazione di pg_hba.conf. Accedere con il seguente comando:

 sudo nano /etc/postgresql/9.4/main/pg_hba.conf

Configuriamo le seguenti voci in questo modo (da md5 a trust):

local   all         all                               trust
host    all         all          trust

 sudo nano /etc/postgresql/9.4/main/postgresql.conf

mettere *

Riavviare il servizio di postgresql:

sudo -u postgres /etc/init.d/postgresql restart

Install Mercurial

sudo apt-get install mercurial

Salvataggio automatico Username e Password Mercurial

Impostiamo la password e username di Mercurial nel file 'hgrc', senza doverle digitare ogni qualvolta che si vuole fare il pull dal repository. Basta accedere al file hgrc nella seguente directory:

sudo nano hgrc

inseriamo all'interno del file le seguenti impostazioni per il salavataggio della password:

bb.prefix =
bb.username = username
bb.password = nomepassw

Adesso, ad ogni pull dal repository, non ci verrà più chiesto di inserire Username e Password.

Install TortoiseHG

da installazione pacchetti  / da riga di comando


Oracle JDK 1.8

Debian 8

echo "deb trusty main" | tee /etc/apt/sources.list.d/webupd8team-java.list echo "deb-src trusty main" | tee -a /etc/apt/sources.list.d/webupd8team-java.list apt-key adv --keyserver hkp:// --recv-keys EEA14886 apt-get update

Ubuntu /luinuxmint

sudo add-apt-repository ppa:webupd8team/java 

idem per entrambi i sistemi

sudo apt-get update 
sudo apt-get install oracle-java8-installer

Installazione iDempiere da sourceforge

Scaricare IDempiere-Server da sourceforge:


mkdir /opt/idempiere mkdir /opt/idempiere/idempiere-server chmod 777 -R /opt *

unzip -d /opt/idempiere

apt-get install zip unzip La cartella 'idempiere-server' appena decompressa deve essere situata nel seguente percorso:


Attenzione: dobbiamo abilitare i permessi di lettura e scrittura

sudo chmod -R 777 opt

Non ci rimane che l'installazione. Come primo passo dobbiamo creare il database. Lanciamo il seguente comando all'interno della cartella 'idempiere-server'


Settiamo i parametri del database (importante che il nome del database sia 'idempiere' e la password 'adempiere' per la lettura dei task) Dopo di ciò andiamo nella cartella 'utils' e lanciamo il comando

cd utils

Installazione completata. Adesso se ritorniamo nella directory precedente e lanciamo il seguente comando, possiamo far partire il nostro iDempiere


Install Eclipse Luna 4.4.1

Opzionale la cartella di eclipse in /opt/eclipse

Download the corresponding version for your operating system from "Eclipse IDE for Java EE Developers"

For Ubuntu 14.04.2 64 bits I downloaded Luna here

On ubuntu the installation of eclipse is just uncompress it and is ready for usage, for the rest of the session let's suppose we uncompressed eclipse on a folder called $ECLIPSE_HOME

On Windows don't try to use the eclipse-installer. By default it places the plugins in the users home, but the ant-scripts require them to stay within the eclipse home.

The first time you run Eclipse it asks for the workspace folder, at this stage you can use the default workspace - it will be changed later.

Install Mercurial Eclipse Plugin 2.0.0
Eclipse Plugin: Eclipse Mercurial

You should install the EclipseMercurial Plugin. There is another good introduction about it. You can install it both from the Eclipse Marketplace (the new way; in the Help menu) or enter a new update site and choose the package "Mercurial Eclipse" (nothing else) (the longer established way).


Seguendo le Following instructions from project:

Install Buckminster 4.4

Following instructions from project:

Now you have your prerequisites ready to receive the iDempiere sources

This tutorial is brought to you by Carlos Ruiz from GlobalQSS. Feel free to improve directly or suggest using the Discussion tab.

Setup in Eclipse

entrare specificando come workspace la directory /opt/repos/idempiere-italia

Poi bisogna configurare il Target Platform: andare su menu Window > Preferences > Plug-in Development > Target Platform (utilizzare il filtro per la ricerca della voce interessata….)

click sul bottone Add; selezionare Nothing: Start with an empty target definition e poi Next; inserire il nome “Adempiere Target Platform”; click su Add; selezionare Directory e poi Next; indicare il path della directory con variabile “${workspace_loc}/targetPlatform”, click su Finish, selezionare il targetPlatform creato e poi Apply; al momento della conferma, sicuramente darà un visualizzazione di errore di cartella inesistente: ignorare errore, se è possibile, verrà risolto con la materializzazione del progetto….

Materializing iDempiere project within Eclipse

Next step is to "materialize" the project. This means that all dependencies are downloaded from the internet.

Navigate to File > Import > Buckminster > Materialize from Buckminster MSPEC, CQUERY or BOM Push the "Next" button and fill the "Enter a URL ..." box (using the "Browse" button) with ".../org.adempiere.sdk-feature/adempiere.mspec" Here eclipse takes some time to review dependencies and after that you can push the "Finish" button Now is a good time to brew some coffee (better Colombian coffee) - Eclipse will download and configure the whole project and this can be time consuming.


After materializing you should first refresh all your projects (mark all projects and use the context menu). Then use "Project -> Clean..." and rebuild all projects. This takes a while and should clear away all error messages. Then I close the "doc" project to get rid of the last error message - it has some unresolved dependencies and is not used for compiling. If you use Java7 you have some hundred warning messages (but they are no real problems), if using Java6 there should be not many of these messages left.

When this step finishes it is recommended to close eclipse and take a backup of the $IDEMPIERE_REPOSITORY folder, in case something mess later you can restore the backup and you won't need to download again the whole thing from internet.

Installazione senza Eclipse (no ambiente di sviluppo


Creazione Database


Create adempiere user
sudo su - postgres
psql -U postgres -c "CREATE ROLE adempiere SUPERUSER LOGIN PASSWORD 'adempiere'"
Create the idempiere database
createdb  --template=template0 -E UNICODE -O adempiere -U adempiere idempiere
psql -d idempiere -U adempiere -c "ALTER ROLE adempiere SET search_path TO adempiere, pg_catalog"
Installing UUID (required to apply some migration scripts)

For postgresql 9.1 and above

   Run the command CREATE EXTENSION "uuid-ossp" using psql
       psql -d idempiere -U adempiere -c 'CREATE EXTENSION "uuid-ossp"'
Import the seed
cd /tmp
jar xvf $IDEMPIERE_REPOSITORY/org.adempiere.server-feature/data/seed/Adempiere_pg.jar
psql -d idempiere -U adempiere -f Adempiere_pg.dmp


jar xvf /opt/repos/idempiere-italia/org.adempiere.server-feature/data/seed/Adempiere_pg.jar
Applying additional migration scripts

Start iDempiere

Eclipse uses so-called "launch configurations" to start a given piece of code using given plugins and given dependencies with given arguments etc. Some of these launch configurations are already preconfigured in the iDempiere workspace.

To start iDempiere try "Run -> Debug Configurations..." and choose what you want to start by selecting one of the launch configurations under "Eclipse Application": - lets you create an file that contains the configuration for the server server.product - starts the zk webserver (needs an file). swingclient.product - starts the swing client In the most developer versions the plugin list (the list of OSGi plugins that are needed to get the whole application running) is not well maintained all the time. You can go to the tab "Plug-Ins" and press the "Validate Plug-Ins" button to check that and press "Add Required Plug-Ins" to add the missing ones.

Then you can start the application.

Modifying the launch configuration

Sometimes I want to have different settings to work with different databases (e.g. test and production). To do that I create a copy of the launch configuration "server.product". I rename the copy according to my needs, e.g. "myown-server.product". Then I go to the tab "Arguments" and add the following to the "VM Arguments" (the lower text field):

To create this file you can copy your or you can even make a copied launch configuration of the "install.product".

You can change other things, e.g. you can add your own plugin to the "Plug-Ins" tab etc.


repository idempiere (sorgenti) ( clone di quello ufficiale)

    • attenzione dimensione superiore ad 1 GB

da tortoise fare il clone solo alla reviosione 1 ..o usare riga di comando

hg clone -r 1
cd idempiere
hg pull -r 2000 -u
hg pull -r 4000 -u
hg pull -r 6000 -u
hg pull -r 8000 -u
hg pull -r 10000 -u
hg pull -u

Setup lingua ITA

Login dal sistema con ruolo di System/System Administrator. Aprire la maschera:

Menu -> System Admin -> General Rules -> System Rules -> Language

Ricerca per nome = it%


- Attivare la checkbox chiamata

  • System Language
  • Login Locale

- Inserire 'dd.MM.yyyy' nel campo 'Date Pattern' per mostrare la data (esempio '31.12.2011').

- Salvare la configurazione e attivare 'Language Maintenance'

Adesso importiamo le traduzioni in italiano

da scaricare o fare un sync con il repository

Sempre da System Administrator apriamo la window 
  • Translation Import/Export
selezioniamo 'Italian' nella selectbox 

'Language' e importiamo lo ZIP 'it_IT_trl_20151222' ps: o eventuale data più recente clicchiamo su :


Al termine dell'importazione lanciamo : da Menu  : 'Syncronize Terminology'