Page History

Please follow the steps below to install OFBiz with the demo data locally on your own machine.

Step-by-step guide

The main steps for installing OFBiz locally are as follows:

1. Install Java SDK
   
   1. The current stable release (1617.1112) needs Java 1.8 as a minimum
   2. If you do not have Java installed then you can download it from here (ADD Link to Java for download) https://adoptopenjdk.net/
      
      
2. Download the latest stable release
   
   1. You can download the latest stable release via the following link (ADD link to Download): https://ofbiz.apache.org/download.html
      
      
3. Building and Starting OFBiz
   1. Extract the downloaded zip file
   2. Open a terminal and navigate into the newly created directory

   3. If you are using Linux enter the following at the command line
      
      

      Code Block
      ./gradlew loadDefaultloadAll ofbiz

      If you are using Windows then enter the following at the command line

      Code Block
      gradlew loadDefaultloadAll ofbiz

      This command will build OFBiz, load the demo data and also start OFBiz running.

       

       

      NOTE: That the terminal running OFBiz will remain active.

      
      

4. Logging into the BackEnd Applications
   1. Logging into the E-Commerce Stores
   2. Stopping OFBiz
   • unpack the release file and go into the newly created directory
   • using the command line, build the system (with demo data) and run it with the following command:

   • gradlew loadDefault ofbiz

     (on Linux and like use "./gradlew" rather than "gradlew")
   • point your browser to http://localhost:8080/catalog and login with username "admin" and password "ofbiz"
   • refer to the README file for further details

    

   1. Building OFBiz

    

   Warning
   title Gradle
   You might need to use Gradle instead of Ant in newer versions, please then refer to the README.MD file at OFBiz folder root

    

   1. OFBiz comes with Apache Ant included and Ant is used to build OFBiz.

   2. To build OFBiz navigate into the ofbiz directory and then run the following command

      Code Block
      $ ./ant load-demo

      Info
      NOTE: This will build OFBiz using the version of Apache Ant that is included. It will also load the demo data that will help you understand OFBiz by seeing some sample transactions and reports.

   1. 1. Open your browser
      2. In the URL address bar enter https://localhost:8443/accounting
      3. The OFBiz login screen will be displayed
      4. Enter "admin" as the username and "ofbiz" as the password
      5. The OFBiz Accounting Manager application screen will be displayed
      6. You have now logged into OFBiz and can now navigate and use any of the back end applications (
      Starting OFBiz
   2. Once the build is complete, you will need to start OFBiz

   To start OFBiz, navigate into the ofbiz directory and then run the following command

   Code Block
   $ ./ant start

   NOTE: If you are running Windows you will need to use the command terminal and run the ant start.bat (NOTE - check if this is correct)Logging into OFBiz and the backend applications

   1. To log into OFBiz and its backend applications you will need to open a browser and enter the following URL

      Code Block
      https://localhost:8443/accounting/control/main

   2. Once the login screen appears

      Login using the user 'admin' with the password 'ofbiz'

      InfoNOTE:All the parties setup with the demo data have the default password 'ofbiz' so you can also login as 'DemoCustomer', 'DemoSupplier' or 'DemoEmployee' 'Accounting' etc)
      
      
   3. Logging into the e-commerce storeTo log into the OFBiz E-Commerce Store
      1. Open your browser (or another browser tab)
      2. In the URL address bar enter https Webstore you will need to open a browser and enter the following URL Code Blockhttp://localhost:80808443/ecommerce/control/main

         Info
         NOTE: You can test the webstore features including shopping cart, blog, newsletter subscriptions, promotions and also buy products using the DemoCustomer profle (User Id = DemoCustomer, password = 'ofbiz').

   4. 1.  

    

   ...

   1. 1. The default OFBiz E-Commerce store screen will be displayed
      2. You have can create orders, register as a new customer or use DemoCustomer as an existing e-commerce customer login
         
         
   2. Stopping OFBiz
      1. Open another terminal and navigate to the ofbiz directory

      2. If you are using Linux enter the following at the command line
         
         

         Code Block
         ./gradlew "ofbiz --shutdown"

         If you are using Windows then enter the following at the command line

         Code Block
         gradlew ofbiz --shutdown

         You may as well using Ctrl+C in the terminal were you started OFBiz, either in Linux or Windows.
         
         

   Info
   A comprehensive INSTALL text file with detailed description of all the commands for running OFBiz can be found in the OFBiz directory

   Related articles

   Content by Label
   showLabels false max 5 spaces OFBENDUSER showSpace false sort modified reverse true type page cql label = "kb-how-to-article" and type = "page" and space = "OFBENDUSER" labels kb-how-to-article

    

   Page properties
   hidden true
   	Related issues