GitLab will be offline for essential maintenance from 22/08/25 - 25/08/25. During this time, GitLab will be read-only with some short periods of complete unavailability.
Clone Joe's original summer work (Ashley has the repo address)
The new web controller code contains a bug meaning the Endorser doesn't properly initialise. This will need fixing properly, but a temporary fix is to run the original web controller which performs setup correctly:
```
cd ../SSI-platform-development-main/webCemo/webcontroller
npm start
```
This needs to be run first because it will default to port 3000, which is what the original web controller expects,
should you wish to explore it.
# For a clean start, clear all docker instances and restart them
```
sudo docker ps -a # lists all docker instances
cd von-network
sudo ./manage stop # stop the von network
cd ../SSI-platform-development-main/webDemo/cloudAgents/
sudo ./manage all stop # stop the docker cloud agents
sudo docker container prune # prune all the agents
sudo docker ps -a # should show no docker instances
```
Run the von-network and ACA-Py cloud agent docker instances
```
cd von-network
sudo ./manage start # start the von network docker instance
cd ../SSI-platform-development-main/webDemo/cloudAgents
sudo ./manage all start # start the docker cloud agents
sudo docker ps -a # should show the running docker instances
```
Start the file server
```
cd ../SSI-platform-development-main/webDemo/file-server
npm start # you may want to clear the /uploads and /imageRegistry folders
```
# Start the new web controllers (Holder-App and all Agents)
```
cd Holder-App
npm start # start Ruths holder app
cd Portal-Apps/IV-Portal-Cavendish/
npm start # answer Y to run on a different port
cd Portal-Apps/IV-Portal-Thoday/
npm start # answer Y to run on a different port
cd Portal-Apps/IV-Portal-Franklin/
npm start # answer Y to run on a different port
```
Of the 4 windows that appear, I recommend splitting the them into two browsers, the left for the Holder-App and the right for the remaining three agents.
Every time you clear the docker instances, you must currently copy the newly generated certificates for Cavendish and Thoday over to the ssi-lib shared library you can find this JSON object outputted to the developer console for Cavendish and Thoday on first running those web apps. copy the objects into
```
/ssi-lib/src/Common.js
```
Here's an example from Cavendish; the schema_id, cred_def_id, issuer_id and schema_issuer_id change every time the von network is cleared and restarted.
1. If you npm install anything to the agents, you may have to npm link ssi-lib again, to relink the shared ssi-lib library again.
2. Not very common, but sometimes the docker instances can fail to initialise properly and it may look as if you code is buggy. in such cases, run `sudo docker logs INSTANCE_ID`. To see if anything is amiss, especially for the web-socket relay docker instances.
3. Don't forget to copy the cavendish and thoday certificates over to ssi-lib whenever you reset the von network dockers; resetting von-network can be handy after many hours of development due to many old credentials appearing in the wallet.
4. Check out package.json where you can find the script to run the Holder-App in an Electron container.
