Skip to content

A scalable large-scale eCommerce framework that is made for multinational omnichannel installations and is easy to customize.


Notifications You must be signed in to change notification settings


Repository files navigation


   _____    _____   _   _____    _    ____      _____   _____    _____
  / ____|  / ____| | | |  __ \  | |  / __ \    |  ___| |  __ \  |  __ \
 | (___   | |      | | | |__) | | | | |  | |   | |___  | |__) | | |__) |
  \___ \  | |      | | |  ___/  | | | |  | |   |  ___| |  _  /  |  ___/
  ____) | | |____  | | | |      | | | |__| |   | |___  | | \ \  | |
 |_____/   \_____| |_| |_|      |_|  \____/    |_____| |_|  \_\ |_|



PRs Welcome Maintainability Read the Docs

SCIPIO ERP - Community Edition

Scipio ERP is a toolkit for the development of modern business applications.

What is Scipio ERP

Scipio ERP is an Open Source Business Application Toolkit based on Java 11+ and a built-in Tomcat application server. We provide standard applications, functions (services) and a well thought-out datamodel, so that you can create modern web applications.

Our templating toolkit simplifies the creation of modern UIs and is compatible with most modern HTML frameworks.



  • Simplifies the creation of business or ECommerce applications
  • Highly modular, extendable and customizable
  • Bundles a long list of working applications
  • Supports most modern HTML frameworks
  • Supports Caching & Clustering
  • Can be rolled out internationally

What's included

  • Business Applications & functions for
    • Accounting
    • Asset Maintenance
    • Catalog Management
    • Content Management
    • Customer Relationship Management (CRM)
    • Ecommerce
    • Human Resource Management
    • Manufacturing Management
    • Order Management
    • User Management
    • Warehouse Management
    • Work Effort (Time tracking)
  • A templating toolkit (freemarker macros) to simplify UI creation
  • A multi-language, multi-national, multi-store Ecommerce application
  • A flexible datamodel
  • Support of various third-party APIs (payment, shipping, apache camel, etc.)


System Requirements

  • Operating System: Windows, Linux, OS X
  • Core 2 Duo or Athlon X2 at 2.4 GHz or higher
  • 4+GB RAM, 2+GB free hard disk space

Software Requirements

  • Java 11 JDK or greater (Openjdk or Oracle)

Recommended Development Tools

  • Git client
  • JetBrains IntelliJ IDEA with Scipio ERP Plugin


In order to install SCIPIO ERP, the following prerequisites must be installed:

  • Java 11 JDK or greater
    • Download and Install
    • Set JAVA_HOME Path (Windows)


The standard way to get SCIPIO ERP is to checkout the master (main) branch, which provides you with the latest stable version with important updates:

  1. Open your command line and run:

Note it is also possible to checkout specific version tags as well as stable version series this way (e.g., git checkout 3.0.0), but main branch typically contains the desirable setup for most demo, server and client usages.

Installation Process

In order to install on a client system or start on a server, the following steps should be used:

  1. Open your command line, go to the extracted folder and run:
  • Linux ./
  • OS X: ./
  • Windows: install.bat
  1. From the same command line run:
  • Linux ./
  • OS X: bash ./
  • Windows: start.bat
  1. To access the application visit the SCIPIO ERP Dashboard: https://localhost:8443/admin

  2. To access the SCIPIO ERP applications from the Dashboard use: Username: admin Password: scipio

If build failure occurs due to missing Nashorn Javascript engine on JDK 15 or later, first run:

  • Linux ./ant download-ant-js
  • OS X: ./ant download-ant-js
  • Windows: ant.bat download-ant-js

Note: These steps are typically too limited for developers; see section below.

                 **Congratulations, you have installed SCIPIO ERP!**


  1. Retrieve latest code updates from git: a. git checkout master b. git pull

  2. Reload visual themes: a. Restart SCIPIO server b. Visit entity utility services page: https://localhost:8443/admin/control/EntityUtilityServices c. Click "Visual Theme Resources - Reload All, Now"

Optional Configuration


Community and enterprise SCIPIO ERP addons can be added to your working copy and updated using the 'git-addons' Bash script in the project root. It requires a Bash 4-compatible terminal (Linux, Mac, Windows Git Bash, Cygwin).

Instructions can be found at:

or for brief help and command list, type:

./git-addons help


We also provide Docker images if you would like to try out Scipio with minimal effort. To create a fully functional SCIPIO ERP instance with some demo data already loaded, you can create a container with the following command:

docker create -p 8080:8080 -p 8443:8443 ilscipio/scipio-erp:demo


For developers, the install/start commands above are typically too limited. The JetBrains IntelliJ IDEA integrated development environment with Scipio ERP Plugin (found in the integrated IDEA plugin store) is highly recommended and, for compilation and development tasks, the traditional bundled Apache Ant commands may and sometimes should be used instead:

  1. Clear local database (Derby), clean out old JARs, build, load demo data to database and start:
  • Linux: ./ant clean-all build load-demo start-debug
  • OS X: ./ant clean-all build load-demo start-debug
  • Windows: ant.bat clean-all build load-demo start-debug

If build failure occurs due to missing Nashorn Javascript engine on JDK 15 or later, first run:

  • Linux: ./ant download-ant-js
  • OS X: ./ant download-ant-js
  • Windows: ant.bat download-ant-js

Commands can be listed using: ant -p (./ant -p)

Commonly used and useful Ant developer commands:

  • clean-all (implies clean-data clean-logs)
  • clean-data (Warning: This deletes local Derby database demo data, but not PostgreSQL/external)
  • clean-logs
  • build
  • rebuild
  • lib-clean-cache-full (in case of maven/ivy issues)
  • lib-update-force (in case of maven/ivy issues)
  • start-debug
  • restart-debug
  • rebuild-debug
  • stop-wait

This is a quick cheat sheet and further information for developers can be found on the website documentation.

Automatically Download Jar Sources

In order for build, lib-update and lib-update-force commands to automatically download third-party JAR sources under component libsrc folders for their corresponding binaries under lib, simply create a file named "" under project root that sets "lib.update.sources=true".

  • Linux/OS X: echo "lib.update.sources=true" >>

After build/lib-update-force is run, IntelliJ IDEA using the Scipio ERP plugin can be instructed to refer to these sources and automatically expand into them using Ctrl+B (a good test is HttpServletRequest):

  • Tools -> Scipio ERP -> Reload Resource Directories

See for other options; and other * files are ignored for version control by .gitignore.


For detailed information and changes about the SCIPIO ERP suite, visit the official website at:

You can get in touch with the us at:


Scipio ERP is a fork of the Apache OFBiz project.

For more details about OFBiz please visit the OFBiz Documentation page:


The source code that makes up The SCIPIO ERP Community Edition (hereinafter referred to as "SCIPIO ERP") and the majority of the libraries distributed with it are licensed under the Apache License v2.0.

Other licenses used by libraries distributed with SCIPIO ERP are listed in the LICENSE file. This file includes a list of all libraries distributed with SCIPIO ERP and the full text of the license used for each.

For additional details, see the NOTICE file.


This software is provided as is and free of charge. There is no warranty or support implied under the terms of the license included.

SCIPIO ERP and the SCIPIO logo are trademarks of Ilscipio GmbH. © Copyright SCIPIO components 2016 Ilscipio GmbH. Apache OFBiz, Apache, the Apache feather logo are trademarks of The Apache Software Foundation.

BIS Crypto TSU exception notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

* Various classes in Scipio, including DesCrypt, HashCrypt, and
 BlowFishCrypt use libraries from the Sun Java JDK API including* and javax.crypto.* (the JCE, Java Cryptography
 Extensions API)
* Other classes such as HttpClient and various related ones use
 the JSSE (Java Secure Sockets Extension) API