{"id":21009,"date":"2026-07-17T08:06:17","date_gmt":"2026-07-17T08:06:17","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=21009"},"modified":"2026-08-20T04:32:02","modified_gmt":"2026-08-20T04:32:02","slug":"how-to-configure-initial-tenant-setup-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-initial-tenant-setup-in-idempiere\/","title":{"rendered":"How to Configure Initial Tenant Setup in iDempiere"},"content":{"rendered":"\n

The Initial Tenant Setup process creates the core business structure required to begin using iDempiere. It automatically generates the Tenant, Organization, users, roles, accounting structure, warehouse, and other standard master records required for system configuration and business operations.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Tenant Name and Organization information must be entered to create the business environment.<\/li>\n\n\n\n
  • Administrative User details must be provided, and Set Initial Password<\/strong> should be enabled.<\/li>\n\n\n\n
  • If a custom Chart of Accounts is unavailable, enable Use Default CoA<\/strong>.<\/li>\n\n\n\n
  • Material Policy should be configured before inventory transactions are processed. It controls the inventory costing method used for stock consumption.<\/li>\n\n\n\n
  • Email settings must be configured and Test Email<\/strong> should complete successfully before using email communication.<\/li>\n<\/ul>\n\n\n\n

    Step-by-Step Configuration<\/strong><\/h2>\n\n\n\n

    Step 1: Open Initial Tenant Setup<\/strong><\/h3>\n\n\n\n

    Navigate to:<\/strong><\/p>\n\n\n\n

    Menu \u2192 Initial Tenant Setup<\/p>\n\n\n\n

    The process window displays the required setup fields.<\/p>\n\n\n\n

    Step 2: Enter Business Information<\/strong><\/h3>\n\n\n\n

    Enter the organization details as shown below.<\/p>\n\n\n\n

    Field<\/strong><\/td>Example Value<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
    Tenant Name<\/td>POTS<\/strong><\/td>Creates the company environment<\/td><\/tr>
    Org Key<\/td>CDC<\/strong><\/td>Short code used to identify the organization<\/td><\/tr>
    Organization Name<\/td>Centralized Distribution Center<\/td>Name of the business unit<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Step 3: Configure Initial Users<\/strong><\/h3>\n\n\n\n

    Enter the users who will access the system.<\/p>\n\n\n\n

    Field<\/strong><\/td>Example Value<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
    Administrative User Name<\/td>PotsAdmin<\/td>Performs configuration and administration activities<\/td><\/tr>
    Administrative User Email<\/td>admin@potsretail.com<\/td>
    <\/td><\/tr>
    Normal User Name<\/td>StoreManager<\/td>Performs daily operational activities<\/td><\/tr>
    Normal User Email<\/td>storemanager@potsretail.com<\/td>
    <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Important: <\/strong>Enable Set Initial Password<\/strong> to allow the system to create passwords automatically during setup.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 4: Enter Organization Location Information<\/strong><\/h3>\n\n\n\n

    Provide the organization address details.<\/p>\n\n\n\n

    Field<\/strong><\/td>Example Value<\/strong><\/td>Purpose<\/strong><\/td><\/tr><\/thead>
    Currency<\/td>INR<\/td>Default currency used for transactions<\/td><\/tr>
    Country<\/td>India<\/td>Business operating country<\/td><\/tr>
    Region<\/td>Tamil Nadu<\/td>Organization location detail<\/td><\/tr>
    City Name<\/td>Chennai<\/td>Organization location detail<\/td><\/tr>
    ZIP<\/td>600001<\/td>Organization location detail<\/td><\/tr>
    Address 1<\/td>Central Office<\/td>Business address<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Note: Some location fields can be updated later if required.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 5: Select Required Accounting Options<\/strong><\/h3>\n\n\n\n

    Enable the following options:<\/strong><\/p>\n\n\n\n

      \n
    • BP Accounting \u2014 Creates accounting setup for customers and vendors<\/li>\n\n\n\n
    • Product Accounting \u2014 Creates accounting setup for inventory and products<\/li>\n\n\n\n
    • Sales Region Accounting \u2014 Creates region-based sales accounting<\/li>\n\n\n\n
    • Use Default CoA \u2014 Automatically creates a standard Chart of Accounts<\/li>\n<\/ul>\n\n\n\n

      Leave disabled unless specifically required:<\/strong><\/p>\n\n\n\n

        \n
      • Project Accounting<\/li>\n\n\n\n
      • Campaign Accounting<\/li>\n\n\n\n
      • Activity Accounting<\/li>\n<\/ul>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

        Step 6: Enter Contact Information<\/strong><\/h3>\n\n\n\n

        Provide the organization contact details.<\/p>\n\n\n\n

        Field<\/strong><\/td>Example Value<\/strong><\/td><\/tr><\/thead>
        Phone<\/td>04440112233<\/td><\/tr>
        2nd Phone<\/td>04440112255<\/td><\/tr>
        Email Address<\/td>support@potsretail.com<\/td><\/tr>
        Tax ID<\/td>GST33AABCP7188K1Z5<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

        Step 7: Run the Process<\/strong><\/h3>\n\n\n\n

        Click OK<\/strong> to start the process. The system will begin creating the required setup records automatically.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        System Generated Records<\/strong><\/h2>\n\n\n\n

        Depending on the selected configuration options, the Initial Tenant Setup process automatically creates the following standard records.<\/p>\n\n\n\n

        Organization and User Records<\/strong><\/h3>\n\n\n\n
          \n
        • Tenant<\/li>\n\n\n\n
        • Organization<\/li>\n\n\n\n
        • Admin Role<\/li>\n\n\n\n
        • User Role<\/li>\n\n\n\n
        • Administrative User<\/li>\n\n\n\n
        • Normal User<\/li>\n\n\n\n
        • Business Partner<\/li>\n\n\n\n
        • Business Partner\u2013User Mapping<\/li>\n\n\n\n
        • Sales Representative<\/li>\n\n\n\n
        • Sales Representative Location<\/li>\n<\/ul>\n\n\n\n

          Note: The user setup process is created automatically for both the Administrative User and Normal User.<\/p>\n\n\n\n

          Accounting Records<\/strong><\/h3>\n\n\n\n
            \n
          • Calendar<\/li>\n\n\n\n
          • Calendar Element<\/li>\n\n\n\n
          • Accounting Schema<\/li>\n\n\n\n
          • Organization Accounting Schema Element<\/li>\n\n\n\n
          • Product Accounting Schema Element<\/li>\n\n\n\n
          • Sales Region Accounting Schema Element<\/li>\n<\/ul>\n\n\n\n

            Business Master Records<\/strong><\/h3>\n\n\n\n
              \n
            • Business Partner Group<\/li>\n\n\n\n
            • Sales Region & Sales Region Translation<\/li>\n\n\n\n
            • Activity & Activity Translation<\/li>\n\n\n\n
            • Campaign & Campaign Translation<\/li>\n\n\n\n
            • Project Cycle<\/li>\n\n\n\n
            • Project<\/li>\n<\/ul>\n\n\n\n

              Product and Pricing Records<\/strong><\/h3>\n\n\n\n
                \n
              • Product Category<\/li>\n\n\n\n
              • Tax Category & Tax Category Translation<\/li>\n\n\n\n
              • Tax Rate<\/li>\n\n\n\n
              • Product<\/li>\n\n\n\n
              • Price List & Price List Version<\/li>\n\n\n\n
              • Product Price<\/li>\n\n\n\n
              • Discount Schema<\/li>\n\n\n\n
              • Payment Term & Payment Term Translation<\/li>\n<\/ul>\n\n\n\n

                Location and Inventory Records<\/strong><\/h3>\n\n\n\n
                  \n
                • Company Location<\/li>\n\n\n\n
                • Business Partner Location<\/li>\n\n\n\n
                • Warehouse Location<\/li>\n\n\n\n
                • Warehouse<\/li>\n\n\n\n
                • Locator<\/li>\n<\/ul>\n\n\n\n

                  Financial and System Records<\/strong><\/h3>\n\n\n\n
                    \n
                  • Cash Book<\/li>\n\n\n\n
                  • Print Formats<\/li>\n<\/ul>\n\n\n\n

                    After successful execution, the system creates the core business structure, standard setup data, accounting configuration, and inventory foundation required for further implementation activities.<\/p>\n\n\n\n

                    Reviewing Tenant Configuration<\/strong><\/h2>\n\n\n\n

                    After the Initial Tenant Setup process is completed, iDempiere automatically creates the Tenant record using the information entered during setup. The Tenant window is then used to maintain company-level settings such as Material Policy<\/p>\n\n\n\n

                    and email communication.<\/p>\n\n\n\n

                    Navigation<\/strong><\/p>\n\n\n\n

                    System Administrator \u2192 Tenant<\/p>\n\n\n\n

                    Material Policy<\/strong><\/h2>\n\n\n\n

                    Material Policy determines the inventory costing method used when inventory is consumed during stock transactions.<\/p>\n\n\n\n

                    Configuration<\/strong><\/p>\n\n\n\n

                      \n
                    1. Open the Tenant window.<\/li>\n\n\n\n
                    2. Select the required Material Policy<\/strong>.<\/li>\n\n\n\n
                    3. Save the record.<\/li>\n<\/ol>\n\n\n\n

                      Example \u2013 FIFO (First In First Out)<\/strong><\/h3>\n\n\n\n
                      Batch<\/th>Quantity<\/th>Unit Cost<\/th><\/tr><\/thead>
                      Batch 1<\/td>100 Units<\/td>\u20b9100<\/td><\/tr>
                      Batch 2<\/td>100 Units<\/td>\u20b9120<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      If 50 units are sold, inventory is consumed from Batch 1 first and the cost applied is \u20b9100 per unit.<\/p>\n\n\n\n

                      Email Communication Setup<\/strong><\/h2>\n\n\n\n

                      The Tenant window also contains the email settings used for outbound communication.<\/p>\n\n\n\n

                      Configure Email Server<\/strong><\/h3>\n\n\n\n
                        \n
                      1. Navigate to the Request Management<\/strong> section.<\/li>\n\n\n\n
                      2. Enter the Mail Host<\/strong> and SMTP Port<\/strong>.<\/li>\n\n\n\n
                      3. Enter the Request Email<\/strong> and Request User<\/strong>.<\/li>\n\n\n\n
                      4. Enable SMTP SSL\/TLS<\/strong>.<\/li>\n\n\n\n
                      5. Save the record.<\/li>\n<\/ol>\n\n\n\n

                        Example<\/strong><\/p>\n\n\n\n

                          \n
                        • Mail Host: smtp.gmail.com<\/li>\n\n\n\n
                        • SMTP Port: 587<\/li>\n<\/ul>\n\n\n\n

                          Configure Email Authentication<\/strong><\/h3>\n\n\n\n
                            \n
                          1. Enable SMTP Authentication<\/strong>.<\/li>\n\n\n\n
                          2. Enter the SMTP authentication credentials (password or application password, depending on the mail provider).<\/li>\n\n\n\n
                          3. Save the configuration.<\/li>\n<\/ol>\n\n\n\n

                            Verify Email Connectivity<\/strong><\/h3>\n\n\n\n
                              \n
                            1. Click Test Email<\/strong>.<\/li>\n\n\n\n
                            2. Confirm the process.<\/li>\n\n\n\n
                            3. Verify the success message and email delivery.<\/li>\n<\/ol>\n\n\n\n

                              This confirms that iDempiere can successfully connect to the configured email server and send outbound emails.<\/p>\n\n\n\n

                              Common Issues<\/strong><\/h2>\n\n\n\n
                              Issue<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
                              Tenant already exists<\/td>Use a unique tenant name<\/td><\/tr>
                              User creation fails<\/td>Verify user information is complete and unique<\/td><\/tr>
                              Missing accounting setup<\/td>Enable Use Default CoA during setup<\/td><\/tr>
                              Currency validation issue<\/td>Verify the currency is correctly configured in the system<\/td><\/tr>
                              Process completes with warnings<\/td>Review the Process Log for details.<\/td><\/tr>
                              Email test fails<\/td>Verify SMTP server, authentication, and network connectivity.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                              Initial Tenant Setup establishes the core business environment in iDempiere by creating the Tenant, Organization, users, roles, accounting structure, warehouse, and other standard master records. This automated process minimizes manual configuration and provides a consistent foundation for subsequent system configuration and business transactions.<\/p>\n\n\n\n

                              Next Steps<\/strong><\/h2>\n\n\n\n

                              After completing the Initial Tenant Setup, continue with the following configuration steps:<\/p>\n\n\n\n

                                \n
                              • Organization Configuration<\/li>\n\n\n\n
                              • Warehouse Configuration<\/li>\n\n\n\n
                              • Product Setup<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

                                The Initial Tenant Setup process creates the core business structure required to begin using iDempiere. It automatically generates the Tenant, […]<\/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-21009","post","type-post","status-publish","format-standard","hentry","category-idempiere-product"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21009","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=21009"}],"version-history":[{"count":2,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21009\/revisions"}],"predecessor-version":[{"id":27661,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21009\/revisions\/27661"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=21009"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=21009"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=21009"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}