Skip to content

Quick setup

David Podhola edited this page Apr 10, 2021 · 1 revision
  1. clone the repository e.g. git clone https://github.com/iDempiere-micro/erpjs.git and cd erpjs to the new cloned repository
  2. yarn to install backend dependencies
  3. copy .env.sample to .env in the root folder
  4. go to clients/admin folder and copy .env.sample to .env
  5. (cd clients/admin && yarn) to install admin client dependencies
  6. open a new terminal and yarn pg to start PostgreSQL
  7. open a new terminal and yarn keycloak to start Keycloak
  8. open a new terminal and yarn api:dev to start API
  9. open a browser and navigate to http://localhost:8080 to Keycloak, login with admin / admin. Left top corner, "Add Realm", "Import" and use file realm-export.json from the docs folder of this repo. Click "Manage Users" (http://localhost:8080/auth/admin/master/console/#/realms/erpjs/users) and add a user with an email identical to the TECHNICAL_USER_EMAIL from the root folder .env file. After the user is created, go to the user details again, click "Credentials" and create a password in the "Reset Password" section, click "Reset Password" button.
  10. open a new terminal and (cd clients/admin && yarn) to start the Admin client, a new browser window will open. Login with the user name and password of the technical user from the previous step.
  11. Enjoy!