Page Comparison

...

1. Start by cloning the CHEFS source code onto your local machine and download the local.json file below such that the directory structure follows /common-hosted-form-service/app/config/local.json 

2. Download chefs_build.zip which contains directory structure and docker file for building CHEFS.

3. Open realm-export.json located at chefs_build/docker/imports/keycloak and search for XXXXXXXXXXXX. This value must match the clientSecret value in local.json so that the CHEFS API can connect to your Keycloak instance. By default, these are set to be equal and don’t need to be altered.

4. Navigate to the CSS page, login with your IDIR, and download the ‘Development’ Installation JSON from your SSO Integration.

5. Back in the realm-export.json file, search for all instances of YYYYYYYYYYYY and replace it with the resource you obtained from the downloaded JSON file. Search for all instances of ZZZZZZZZZZZZ and replace it with the secret. 

...

All the files are now configured and you can run Keycloak and PostgreSQL.

...

Build

1. Start Docker, open a terminal in the /chefs_build directory, and run the following command:

   Code Block
   docker compose up

   This will start up an instance for your Keycloak and PostgreSQL containers. If you don’t want to keep the terminal open, you can append a -d to the end of the command above.

2. Next, open a terminal in the directory /common-hosted-form-service/app and run the following commands:

   Code Block
   npm install npm run migrate npm run seed:run npm run serve

   This will start the process for the CHEFS API.

3. Open another terminal in the directory /common-hosted-form-service/app/frontend and run the following commands:

   Code Block
   npm install npm run serve

   This will start the process for the CHEFS front end.

...