1.1 Deployment: Local Installation - SAP/application-support-center GitHub Wiki
You can run ASC locally for development or to test out its functionality. You could also use this setup to run a production instance of ASC. Keep in mind that there is no user or role provisioning, or database backups considered with this deployment method (as Cloud Foundry handles these).
The Server/API uses Node.js/Express and uses Postgres for persistence
Install Node.js and Postgres, create and take note of the Postgres user account.
Clone or download this core repo and run npm install in the server folder to download the relevant dependencies.
Setup a new schema in your Postgres database called asc
, and execute the creation script in resources\asc.sql
to create the DB objects, you can do this via the psql command line tools or using a visual tool such as Datagrip.
Rename the .env_template file to .env in the \server
folder. This file needs to have the required environment variables (such as the Postgres hostname, username and password) defined.
cd server
npm run dev
The following output should be shown:
App Info
- Environment: dev
- API Endpoint: http://localhost:5001/api/v1
- API Documentation: http://localhost:5001/api/v1/docs # Swagger API Documentation
- Landing UI: http://localhost:5001/
- Admin UI: http://localhost:5001/admin
- Portal UI: http://localhost:5001/portal
- Integration tests: http://localhost:5001/admin/test/integration/opaTests.qunit.html # Run Frontend Integration Tests
As mentioned, with this deployment method the application runs using a single Admin user which can be configured in server/auth.js and be queried using /api/v1/users/me