A privacy preserving federated learning solution

Documentation • Contributing • References

---

This repository is part of vantage6, and contains the code for our User Interface. This is a web application that allows you to communicate easily with your vantage6 server.

How to use

For instructions on how to run your own user interface, see the instructions below.

If you are using our Cotopaxi server you can use this user interface by logging on to https://portal.cotopaxi.vantage6.ai/. Contact us if you would like to have a user account.

Note that the user interface is not available for older vantage6 servers such as Harukas (v2). Please consider upgrading your project to Petronas (v3), or rather Cotopaxi (v4).

Running the UI

This UI is an Angular (version 14.1.3) application. For general information on how to work with Angular, we refer to the Angular CLI home page. You may need to install these requirements to run Angular applications locally.

Before running the application, you may need to update the configuration. Update the file in src/environments/environment.ts to set where your vantage6 server is running (or, alternatively, update environment.prod.ts if you want to run a production application).

When you have completed the steps above, run

ng serve

for a development server. Navigate to http://localhost:4200/ to use it.

Deployment

Angular production servers can be deployed in many ways. Angular's deployment documentation offers a number of options.

Alternatively, we provide the Docker image harbor2.vantage6.ai/infrastructure/ui to help you deploy your own UI. In that case, run

docker run --env SERVER_URL="<your_url>" --env API_PATH="<your_path>" -p 8080:80 harbor2.vantage6.ai/infrastructure/ui:latest

to run a UI on port 8080 that communicates with your own server. For instance, you can point to a local server with default settings if you set SERVER_URL=http://localhost:5000 and API_PATH=/api. If you don't enter environment variables, the UI points to https://cotopaxi.vantage6.ai by default.

Note that you can also use another UI image tag than ui:latest. For example, you can specify a version of the UI such as ui:3.6.0. Another option is to use the tag ui:cotopaxi, which defaults to the latest v4 version.