{"id":29851,"date":"2026-10-22T11:06:31","date_gmt":"2026-10-22T11:06:31","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=29851"},"modified":"2026-11-11T04:00:56","modified_gmt":"2026-11-11T04:00:56","slug":"how-it-works-install-and-set-up-the-idempiere-server-on-ubuntu","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-it-works-install-and-set-up-the-idempiere-server-on-ubuntu\/","title":{"rendered":"HOW IT WORKS &#8211; Install and Set Up the iDempiere Server on Ubuntu"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\"><strong>Overview<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This guide explains how to download the stable iDempiere server package, prepare its installation directory, create a PostgreSQL database account and database, configure the application server, import the initial database seed, and start iDempiere. The final step verifies the setup by opening the application in a web browser.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>What you will complete<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Download the Linux server archive for the required iDempiere version.<\/li>\n\n\n\n<li>Place the server files under \/opt and assign ownership to a dedicated system account.<\/li>\n\n\n\n<li>Create a PostgreSQL application role and database.<\/li>\n\n\n\n<li>Run the iDempiere console setup and save the server configuration.<\/li>\n\n\n\n<li>Import the initial iDempiere database structure and seed data.<\/li>\n\n\n\n<li>Start the server and sign in to verify that the application is available.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Before you begin<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Ubuntu 24.04 LTS or Ubuntu 22.04 LTS<\/strong> is installed and you can open a terminal.<\/li>\n\n\n\n<li>Java 17 is installed and its JAVA_HOME points to the correct Java 17 directory.<\/li>\n\n\n\n<li>PostgreSQL is installed and running, with access to the local PostgreSQL administrator account.<\/li>\n\n\n\n<li>You have sudo privileges and enough disk space for the server package and database.<\/li>\n\n\n\n<li>You have downloaded the Linux x86_64 server archive for the version you intend to use.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Important:<\/strong> The commands below use iDempiere version 13 and the example database name\/user shown in the video. Confirm archive names and paths against the package you actually downloaded. Do not use the example password in a production environment.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Download the iDempiere Stable Server<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Open the official iDempiere files repository:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">SourceForge: <span><a href=\"https:\/\/sourceforge.net\/projects\/idempiere\/files\/\" style=\"text-decoration: none;color: blue;font-weight: bold\" target=\"_blank\" rel=\"noopener\">https:\/\/sourceforge.net\/projects\/idempiere\/files\/<\/a><\/span><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the directory for the required release, such as v13.<\/li>\n\n\n\n<li>Open the server folder for that release.<\/li>\n\n\n\n<li>Download the server archive that matches your operating system and architecture. For this walkthrough, use the Linux x86_64 package.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the downloaded archive in a known directory, such as your Downloads folder. The following commands assume you run them from the directory containing the ZIP file.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Extract the Package and Prepare Directories<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">1.  Extract the downloaded archive. Replace the archive name if the downloaded file uses a different name.<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> unzip idempiereServer13.gtk.linux.x86_64.zip<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"845\" height=\"597\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-UnZip-2.png\" alt=\"TenthPlanet-iDempiere-SetUp-UnZip\" class=\"wp-image-29904\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-UnZip-2.png 845w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-UnZip-2-300x212.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-UnZip-2-767x542.png 767w\" sizes=\"auto, (max-width: 845px) 100vw, 845px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">2. Move the extracted server directory to \/opt, a conventional location for optional application software:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo mv idempiere.gtk.linux.x86_64\/idempiere-server \/opt\/<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"901\" height=\"603\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-MoveToOPT.png\" alt=\"TenthPlanet-iDempiere-SetUp-MoveToOPT\" class=\"wp-image-29906\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-MoveToOPT.png 901w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-MoveToOPT-300x201.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-MoveToOPT-767x513.png 767w\" sizes=\"auto, (max-width: 901px) 100vw, 901px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">3. Create a dedicated system account for the server process, then assign ownership of the installation directory to it:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo adduser --system --home \/opt\/idempiere-server --group idempiere\n sudo chown -R idempiere:idempiere \/opt\/idempiere-server<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"904\" height=\"508\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-OptFolderPermission.png\" alt=\"TenthPlanet-iDempiere-SetUp-OptFolderPermission\" class=\"wp-image-29909\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-OptFolderPermission.png 904w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-OptFolderPermission-300x169.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-OptFolderPermission-767x431.png 767w\" sizes=\"auto, (max-width: 904px) 100vw, 904px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Why use a dedicated account?<\/strong> Running the application under a separate service account avoids running it as root and makes file ownership easier to manage.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Create the PostgreSQL Role and Database<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">1. Switch to the PostgreSQL operating-system account:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo -i -u postgres<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">2. Create the application database role. PostgreSQL prompts you to enter and confirm a password:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> createuser -P adempiere<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">3. Create a database named idempiere owned by the adempiere role:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> createdb -O adempiere idempiere<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">4. Exit the PostgreSQL shell:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> exit<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"904\" height=\"502\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-Postgre-DBandUser.png\" alt=\"TenthPlanet-iDempiere-SetUp-Postgre-DBandUser\" class=\"wp-image-29912\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-Postgre-DBandUser.png 904w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-Postgre-DBandUser-300x167.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-Postgre-DBandUser-767x426.png 767w\" sizes=\"auto, (max-width: 904px) 100vw, 904px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Database details used in this walkthrough<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><strong>Setting<\/strong><\/td><td><strong>Value<\/strong><\/td><\/tr><tr><td><strong>Database type<\/strong><\/td><td>PostgreSQL<\/td><\/tr><tr><td><strong>Host<\/strong><\/td><td>localhost<\/td><\/tr><tr><td><strong>Port<\/strong><\/td><td>5432<\/td><\/tr><tr><td><strong>Database name<\/strong><\/td><td>idempiere<\/td><\/tr><tr><td><strong>Application role<\/strong><\/td><td>adempiere<\/td><\/tr><tr><td><strong>Password<\/strong><\/td><td>The password entered when creating the role<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Use a strong, unique password. The example password mentioned in the voice-over is for demonstration only and should not be reused.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Configure the iDempiere Application Server<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">iDempiere provides two ways to configure the application server on Linux:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li><strong>GUI Setup<\/strong> \u2014 Configure the server using the graphical setup window.<\/li>\n\n\n\n<li><strong>Console Setup<\/strong> \u2014 Configure the server through the terminal.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Both methods configure the application server, database connection, network ports, security settings, and optional mail settings. Choose either method based on whether you have access to a graphical desktop environment.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Method 1: GUI-Based Setup (Recommended for Desktop Environments)<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The graphical setup is useful when you want to configure iDempiere through a visual interface rather than answering terminal prompts.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Open the iDempiere Installation Directory<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">1. Open a terminal and navigate to the installation directory:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> cd \/opt\/idempiere-server<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">2. Launch the graphical setup script:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo .\/setup.sh<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"810\" height=\"504\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Prompt-1.png\" alt=\"TenthPlanet-iDempiere-SetUp-GUI-Prompt\" class=\"wp-image-29931\" style=\"aspect-ratio:1.607192683304914;width:840px;height:auto\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Prompt-1.png 810w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Prompt-1-300x187.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Prompt-1-400x250.png 400w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Prompt-1-767x477.png 767w\" sizes=\"auto, (max-width: 810px) 100vw, 810px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If the script is executable and your installation supports the graphical setup, the <strong>iDempiere Server Setup<\/strong> window will open.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"785\" height=\"681\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-SetUp-Before-1.png\" alt=\"TenthPlanet-iDempiere-SetUp-GUI-SetUp-Before\" class=\"wp-image-29927\" style=\"aspect-ratio:1.1443033978940722;width:840px;height:auto\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-SetUp-Before-1.png 785w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-SetUp-Before-1-300x260.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-SetUp-Before-1-768x666.png 768w\" sizes=\"auto, (max-width: 785px) 100vw, 785px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> The GUI setup requires a graphical desktop environment. The script name and launch requirements can vary by iDempiere package. If <code>setup.sh<\/code> is not available, check the files included in your installation directory.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Configure the Java Settings<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Java<\/strong> section, configure the Java runtime used by the iDempiere server.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><th>Field<\/th><th>Value \/ Instructions<\/th><\/tr><tr><td>Java Home<\/td><td>Enter the installed Java 17 directory, such as <code>\/usr\/lib\/jvm\/java-17-openjdk-amd64<\/code>.<\/td><\/tr><tr><td>Java Options<\/td><td>Review the default JVM options. Change memory settings only when required by your workload and available RAM.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">To verify your Java installation, run:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> java -version\n readlink -f \"$(which java)\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Use the actual JDK\/JRE home directory appropriate for your installation.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Configure iDempiere Settings<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>iDempiere<\/strong> section, configure the installation directory and keystore.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><th>Field<\/th><th>Value \/ Instructions<\/th><\/tr><tr><td>iDempiere Home<\/td><td><code>\/opt\/idempiere-server<\/code><\/td><\/tr><tr><td>KeyStore Password<\/td><td>Enter a strong password for the server&#8217;s keystore.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the keystore password secure. Do not publish it in screenshots, tutorials, or source control.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 4: Configure the Application Server<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Application Server<\/strong> section, configure the server address and ports.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><th>Field<\/th><th>Example value<\/th><th>Purpose<\/th><\/tr><tr><td>Application Server<\/td><td><code>0.0.0.0<\/code><\/td><td>Binds to all available IPv4 interfaces when supported.<\/td><\/tr><tr><td>Web Port<\/td><td><code>8080<\/code><\/td><td>HTTP access port.<\/td><\/tr><tr><td>SSL<\/td><td><code>8443<\/code><\/td><td>HTTPS access port.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Important:<\/strong> Binding to <code>0.0.0.0<\/code> exposes the service on all applicable network interfaces. Restrict access through your firewall and deployment configuration. For production, configure HTTPS and valid certificates appropriately.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 5: Configure the PostgreSQL Database<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Database Server<\/strong> section, configure the database connection.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If PostgreSQL is already installed, running, and the target database has been created, select <strong>DB Already Exists<\/strong> when appropriate.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><th>Field<\/th><th>Example value<\/th><\/tr><tr><td>Database Server<\/td><td><code>localhost<\/code><\/td><\/tr><tr><td>Database Name<\/td><td><code>idempiere<\/code><\/td><\/tr><tr><td>Database Port<\/td><td><code>5432<\/code><\/td><\/tr><tr><td>Database User<\/td><td><code>adempiere<\/code><\/td><\/tr><tr><td>Database Type<\/td><td><code>PostgreSQL<\/code><\/td><\/tr><tr><td>Database Search<\/td><td>Select the appropriate option if required by your package.<\/td><\/tr><tr><td>DB Admin Password<\/td><td>Enter the PostgreSQL administrator password if requested.<\/td><\/tr><tr><td>Database Password<\/td><td>Enter the password assigned to the <code>adempiere<\/code> role.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">These are example values. They must match the PostgreSQL database and role created during the database setup.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Before continuing, verify that:<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>PostgreSQL is running.<\/li>\n\n\n\n<li>The target database exists.<\/li>\n\n\n\n<li>The <code>adempiere<\/code> role has the required permissions.<\/li>\n\n\n\n<li>The database credentials are correct.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Do not confuse the PostgreSQL administrator password with the application database user&#8217;s password.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 6: Configure Mail Settings<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Mail Server<\/strong> section, configure outgoing email if your deployment requires it.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><th>Field<\/th><th>Instructions<\/th><\/tr><tr><td>Mail Server<\/td><td>Enter your SMTP server hostname.<\/td><\/tr><tr><td>Mail User<\/td><td>Enter the SMTP authentication username, if required.<\/td><\/tr><tr><td>Admin Email<\/td><td>Enter the administrator&#8217;s email address.<\/td><\/tr><tr><td>Mail Password<\/td><td>Enter the SMTP password or supported credential.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">For a local test environment, leave these fields unconfigured only if the setup permits it and email functionality is not required. For production, use the correct SMTP server and secure credentials.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 7: Test and Save the Configuration<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">At the bottom of the setup window, use the available controls:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Click <strong>Test<\/strong> to validate the configuration if the package supports the test operation.<\/li>\n\n\n\n<li>Review any connection errors and correct the relevant fields.<\/li>\n\n\n\n<li>Click <strong>Save<\/strong> to write the configuration.<\/li>\n\n\n\n<li>Review the terminal output or logs for errors.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"788\" height=\"686\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Success.png\" alt=\"TenthPlanet-iDempiere-SetUp-GUI-Success\" class=\"wp-image-29937\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Success.png 788w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Success-300x261.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-GUI-Success-767x668.png 767w\" sizes=\"auto, (max-width: 788px) 100vw, 788px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Saving the configuration does not necessarily mean that the server has started successfully. Confirm the configuration was written and then proceed to the server startup and verification steps.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Method 2: Console-Based Setup<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Use this method when you prefer the terminal or are configuring a headless Linux server without a graphical desktop.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Open the Installation Directory<\/strong><\/h3>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code>  cd \/opt\/idempiere-server<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Launch Console Setup<\/strong><\/h3>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo .\/console-setup.sh<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"806\" height=\"502\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-1.png\" alt=\"TenthPlanet-iDempiere-SetUp-ConsoleBased\" class=\"wp-image-29963\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-1.png 806w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-1-300x187.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-1-400x250.png 400w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-1-767x478.png 767w\" sizes=\"auto, (max-width: 806px) 100vw, 806px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Follow the prompts. The exact wording and available options depend on the installed iDempiere package.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><strong>Console  prompt<\/strong><\/td><td><strong>What to enter \/ check<\/strong><\/td><\/tr><tr><td><strong>Java Home<\/strong><\/td><td>Confirm the installed Java 17 path, for example \/usr\/lib\/jvm\/java-17-openjdk-amd64.<\/td><\/tr><tr><td><strong>Java options \/ memory<\/strong><\/td><td>Review the displayed defaults and adjust only if your machine has sufficient memory and the deployment requires it.<\/td><\/tr><tr><td><strong>Installation directory<\/strong><\/td><td>Confirm \/opt\/idempiere-server.<\/td><\/tr><tr><td><strong>Keystore \/ certificate details<\/strong><\/td><td>Set a secure keystore password. Use suitable certificate identity values for your environment.<\/td><\/tr><tr><td><strong>HTTP \/ HTTPS ports<\/strong><\/td><td>The walkthrough uses 8080 for HTTP and 8443 for HTTPS. Ensure these ports are available.<\/td><\/tr><tr><td><strong>Database already running<\/strong><\/td><td>Answer Yes if PostgreSQL is already installed, running, and the target database has been created.<\/td><\/tr><tr><td><strong>Database driver<\/strong><\/td><td>Select PostgreSQL.<\/td><\/tr><tr><td><strong>Database host \/ port<\/strong><\/td><td>Use localhost and 5432 for a local PostgreSQL instance.<\/td><\/tr><tr><td><strong>Database name \/ user<\/strong><\/td><td>Use idempiere and adempiere, matching the database created above.<\/td><\/tr><tr><td><strong>Database password<\/strong><\/td><td>Enter the password assigned to the adempiere PostgreSQL role.<\/td><\/tr><tr><td><strong>Database administrator credentials<\/strong><\/td><td>Provide the required database administrator credentials if the setup console requests them. Avoid sharing or recording these credentials.<\/td><\/tr><tr><td><strong>Mail settings<\/strong><\/td><td>For a local trial, optional mail settings may be left unconfigured if the console allows it.<\/td><\/tr><tr><td><strong>Save configuration<\/strong><\/td><td>Confirm the option to write the configuration and generate\/update the launch scripts.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Verify the Setup<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">After the console setup finishes, review the terminal output for errors. Confirm that the configuration was saved and that the required server launch scripts are available.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If the configuration or connection test fails, verify the Java path, PostgreSQL service status, database credentials, permissions, and port availability before proceeding.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"813\" height=\"618\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-Output.png\" alt=\"TenthPlanet-iDempiere-SetUp-ConsoleBased-Output\" class=\"wp-image-29964\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-Output.png 813w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-Output-300x228.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ConsoleBased-Output-767x583.png 767w\" sizes=\"auto, (max-width: 813px) 100vw, 813px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Which Method Should You Use?<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><th>Requirement<\/th><th>Recommended method<\/th><\/tr><tr><td>Linux desktop with a graphical environment<\/td><td>GUI setup<\/td><\/tr><tr><td>Remote server accessed through SSH<\/td><td>Console setup<\/td><\/tr><tr><td>Prefer visual field-by-field configuration<\/td><td>GUI setup<\/td><\/tr><tr><td>Headless server or terminal-only workflow<\/td><td>Console setup<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Expected result:<\/strong> After completing either method, the iDempiere server configuration should be saved and ready for the next stage: starting the application server and verifying access through the configured web port.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Import the Initial iDempiere Database<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">1. Move to the server&#8217;s utils directory:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> cd \/opt\/idempiere-server\/utils<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">2. Run the database import script:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> sudo .\/RUN_ImportIdempiere.sh<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"808\" height=\"502\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport.png\" alt=\"TenthPlanet-iDempiere-SetUp-DatabaseImport\" class=\"wp-image-29965\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport.png 808w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-300x186.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-768x477.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-400x250.png 400w\" sizes=\"auto, (max-width: 808px) 100vw, 808px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Read the warning shown by the script. If it asks for confirmation to initialize or overwrite the target database, continue only if this is the intended new\/demo database and you are comfortable replacing its contents. Press Enter or provide the requested confirmation according to the prompt.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Caution:<\/strong> Database import can create or replace schema and seed data. Never run an overwrite\/import operation against a database containing information you need to preserve. Back up important data first.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Wait for the script to complete and review the output for errors before starting the server.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"769\" height=\"440\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-Result.png\" alt=\"TenthPlanet-iDempiere-SetUp-DatabaseImport- Result\" class=\"wp-image-29966\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-Result.png 769w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-DatabaseImport-Result-300x172.png 300w\" sizes=\"auto, (max-width: 769px) 100vw, 769px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Start the iDempiere Server<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Return to the server installation directory and start the server:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> cd \/opt\/idempiere-server\n sudo .\/idempiere-server.sh<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"817\" height=\"504\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ServerStart.png\" alt=\"TenthPlanet-iDempiere-SetUp-ServerStart\" class=\"wp-image-29968\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ServerStart.png 817w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ServerStart-300x185.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-ServerStart-767x473.png 767w\" sizes=\"auto, (max-width: 817px) 100vw, 817px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the terminal open while the server is running. Review the startup output and wait for the application to finish initializing. If startup reports a port conflict, database connection problem, or Java configuration error, resolve it before testing the browser interface.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Open iDempiere in a Web Browser<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Open a browser on the same machine and navigate to the configured application URL. With the example HTTP port, try:<\/p>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code> http:&#047;&#047;localhost:8080<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"505\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080-1024x505.png\" alt=\"TenthPlanet-iDempiere-SetUp-localhost8080\" class=\"wp-image-29971\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080-1024x505.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080-300x148.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080-766x378.png 766w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080-1536x758.png 1536w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/10\/TenthPlanet-iDempiere-SetUp-localhost8080.png 1906w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If the setup has configured a different host name, port, or HTTPS endpoint, use the URL shown by your installation configuration.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sign in with the appropriate iDempiere SuperUser\/System credentials for the imported seed database. Use the credentials supplied for your installation; do not assume that every package or database uses the same password.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After logging in, open the Business Partner window from the application navigation menu. Confirm that the window opens and that the expected initial data is available. This provides a basic end-to-end check that the application can communicate with the database.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Verification Checklist<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The server archive was extracted successfully and the files are under \/opt\/idempiere-server.<\/li>\n\n\n\n<li>The idempiere system account owns the installation directory.<\/li>\n\n\n\n<li>The PostgreSQL role adempiere and database idempiere exist.<\/li>\n\n\n\n<li>The console setup completed and saved the server configuration.<\/li>\n\n\n\n<li>The database import script completed without errors.<\/li>\n\n\n\n<li>The server starts without fatal Java, database, or port errors.<\/li>\n\n\n\n<li>The application URL opens in a browser.<\/li>\n\n\n\n<li>You can sign in and open the Business Partner window.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Common Issues to Check<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><strong>Symptom<\/strong><\/td><td><strong>First checks<\/strong><\/td><\/tr><tr><td><strong>Java path is incorrect<\/strong><\/td><td>Verify Java 17 is installed and confirm the JAVA_HOME path used by the setup console.<\/td><\/tr><tr><td><strong>Database connection fails<\/strong><\/td><td>Check that PostgreSQL is running, port 5432 is listening, the database and role exist, and the password is correct.<\/td><\/tr><tr><td><strong>Import fails<\/strong><\/td><td>Read the first meaningful error in the import output, verify database access, and confirm the target database is the intended empty\/demo database.<\/td><\/tr><tr><td><strong>Port 8080 or 8443 is already in use<\/strong><\/td><td>Identify the process using the port or configure iDempiere to use an available port, then update the URL accordingly.<\/td><\/tr><tr><td><strong>Browser cannot connect<\/strong><\/td><td>Confirm server startup completed, use the configured port and protocol, and check local firewall\/network settings.<\/td><\/tr><tr><td><strong>Permission denied<\/strong><\/td><td>Review ownership and permissions under \/opt\/idempiere-server. Avoid solving permission problems by running the application permanently as root.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Completion<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The local iDempiere server setup is complete when the database import finishes successfully, the server starts without fatal errors, and you can sign in through the browser and open the Business Partner window. The environment is then ready for further configuration and demonstration use. For a production deployment, review security, TLS certificates, credentials, backups, service management, and resource sizing separately.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity is-style-dots\" \/>\n\n\n\n<p class=\"wp-block-paragraph\"><div class=\"epyt-video-wrapper\"><iframe loading=\"lazy\"  id=\"_ytid_18516\"  width=\"800\" height=\"450\"  data-origwidth=\"800\" data-origheight=\"450\"  data-relstop=\"1\" src=\"https:\/\/www.youtube.com\/embed\/pi4Blytq6Bo\">https:\/\/www.youtube.com\/watch?enablejsapi=1&autoplay=0&cc_load_policy=0&cc_lang_pref=&iv_load_policy=1&loop=0&rel=0&fs=1&playsinline=0&autohide=2&theme=dark&color=red&controls=1&disablekb=0&\" class=\"__youtube_prefs__  no-lazyload\" title=\"YouTube player\"  allow=\"fullscreen; accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen data-no-lazy=\"1\" data-skipgform_ajax_framebjll=\"\"><\/iframe><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Overview This guide explains how to download the stable iDempiere server package, prepare its installation directory, create a PostgreSQL database [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-29851","post","type-post","status-publish","format-standard","hentry","category-idempiere-product"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/29851","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=29851"}],"version-history":[{"count":34,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/29851\/revisions"}],"predecessor-version":[{"id":30105,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/29851\/revisions\/30105"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=29851"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=29851"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=29851"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}