From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.

Server Setup On Line Help


Java Home: select the SDK Java Home location (e.g. C:\jdk1.5.0_05).

Java VM: the Java Virtuel Engine Vendor (Default= Sun).

Please, note that ADempiere requires the Java System Development Kit (JDK), not just the runtime environment (JRE).


ADempiere Home: is the base directory where the distribution files are located (e.g. C:\Adempiere).

KeyStore Password: ADempiere requires a SSL certificate. It automatically creates a certificate in the key store $ADEMPIERE_HOME/keystore/myKeystore with the keystore password entered.

The self certified certificate created has the alias adempiere and uses the same password as the keystore.

You can replace the certificate used with the Java "keytool" (see Java tool documentation).

Application Server

Application Server: is the name, URL or IP of your server PC (Don't use localhost). The Application Server defaults to the server you started the program. Avoid using IP addresses - use the DNS name of the server.

Please keep in mind that under Linux/Unix ports under 1000 need root privileges. The default ports are:

  • 80 for http connections and
  • 443 for SSL connections.

If you use Apache as a front end, you could use port 8080 and 8443.

Your options are to use another Web port, e.g. 8888. If you are using Oracle and depending of your setup, port 8080 might be used.

JNP (RMI): Default ports are 1099 (1098).

Database Server

Database Server: The Database Server defaults to the server you started the program. Avoid using IP addresses - use the DNS name of the server. Don't use localhost unless the server is running on the same machine as the client software.

For Oracle, the Service names are discovered. You an overwrite the entries, if they are not correct.

Database Name:

  • PosgreSQL: PostgreSQL database name
  • Oracle: SID/Service name. Oracle 10g/11g default: orcl, OracleXE default: xe

Database Type: select the database you have installed (i.e. Oracle 10g, Oracle 10gXE, PostgreSQL).

Database Port: select the port for connect to database.(i.e. Oracle use 1521 as standard port, PostgreSQL 5432, etc.)

System Password:

  • Oracle: Password for the system user.
  • PostgreSQL: Password for the postgres user.

Database User: The application database user name, default is adempiere.

Database Password: The application database password, default is adempiere.

Mail Server

The EMail connection here is used as the default. You maintain the EMail connection in the Application on a Client basis.

It is not required that at this point, the program can read your emails. But, you need an IMAP server for Request processing.

If you don't want to enter or don't have a SMTP server, just enter a valid server. If the server exists, but does not provide POP3, SMTP or IMAP, the setup finishes successfully. If the sevrevr is invalid, then fails.

Common Issues

See here for some common problems and how to fix them.