Setting up DIVOC development environment
Step 1: Install prerequisites and dependencies
- Update package list - sudo apt-get update.
- Install docker - sudo apt install docker.io.
- Install docker-compose - sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose.
- Install git - sudo apt install git.
- You can find the basic Docker Compose commands below: (DIVOC repo has docker-compose-vc-issuance.yml file which lists all the services required for VC Issuance)
Step 2: Install DIVOC
- Navigate to the DIVOC directory - cd DIVOC.
- Configure DIVOC: Configurations are provided as environment variables and a default set of configurations is provided in the ‘.env.example’ file. Make a copy of this file named ‘.env’ that docker will pick up. Edit these configurations as per your need.
'cp .env.example .env'
Step 3: Start keycloak and kafka services in the detached mode.
docker-compose -f docker-compose-vc-issuance.yml up -d kafka keycloak
- Verify the state of kafka and keycloak containers. If they are up and running, Other services can be started now in detached mode.
docker-compose -f docker-compose-vc-issuance.yml up -d
- Some services might fail to start because the dependent service may not be ready yet. Restarting the failed service should start it successfully in this case.
- On Mac/Windows, services may crash with exit code:137, if sufficient memory is not set for docker. This can be changed in the Docker desktop preferences, resources tab, as shown here.
Step 4: To build docker images locally after making changes, run following commands make docker (Available within the individual micro services folder and at parent level folder as well).
docker-compose -f docker-compose-vc-issuance.yml up -d
Step 5: Explore DIVOC
- The following are the routes to access local apps. The remaining routes can be found in nginx/nginx.conf.
Address | Application |
---|---|
localhost | tenant-portal |
localhost/vc-verification-app | Verification app |
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

Last modified 5mo ago