1 - Prerequisites

Access rights

Partner access

You will need the so-called censhare partner access/account to be able to access the following:

the censhare partner portal, in particular, the download portal;
the GitLab repositories with the source code.

Administrator access to the censhare Server

On some steps, you will need to access the censhare Server as an admin.

If you do not have access, open a support ticket to get it.
If you are not entitled to receive admin access, please make sure that someone - e.g. your project manager - will arrange an exchange with a censhare administrator. In this case, the administrator will have to perform the part described in this tutorial. You will need to pass some input to them, and they will need to return you some results. After that, you will be able to continue the installation.

Steps that require such access:

Developer machine `docker compose`

docker compose runs multiple containers at once. This is only needed for development purposes. Below you will find the requirements for each supported operating system.

Mac (OS X)

Docker Desktop is the only requirement. Docker Compose is part of the standard Docker Desktop installation, in version 2.x named docker-compose.

Linux

docker and Docker Compose:

Docker Compose must be explicitly installed as an additional plugin (version 3.x) or a separate Python script (version 2.x).
Please make sure that the docker itself (Docker CE) has the latest possible version. Some newer versions of Docker Compose don\'t work with the older version of Docker CE, and such combination would lead to very strange errors.
! Not supported: docker alternatives, e.g. podman
bash version 3.2.x or higher must be available. TThis is standard in all mainstream Linux distributions, but please check this requirement in case of using some custom or special distributions.

Windows

Docker Desktop and Windows Subsystem for Linux

CODE

- *Docker Compose* is part of the standard Docker Desktop installation, in version 2.x named `docker-compose`

bash version 3.2.x or higher must be available. This is standard in all mainstream Linux distributions, but please check this requirement in case of using some custom or special distributions.

censhare administrator machine

If you do not have admin rights for the censhare server and need to cooperate with someone else, make sure that this person has Java/JDK installed on their machine.