<aside> 📌

</aside>

1. Install KAWA’s Python client

Some of the advanced administration tasks are managed through KAWA’s Python client.

In order to install it, you need python 3.8 at least.

Run the following command to install KAWA Client:

pip install kywy --upgrade --extra-index-url [<https://kawa:[email protected]/api/v4/projects/31007056/packages/pypi/simple>](<https://kawa:[email protected]/api/v4/projects/31007056/packages/pypi/simple>)

⚠️ Make sure that the machine on which you install the python client has access to the KAWA server (via HTTP(S) on whatever port was configured on the server).

2. Setup the setup-admin user

The setup-admin user is unique inside each KAWA instance. It has the privileges of any admin user, but can never be downgraded to non-admin nor deactivated.

2.a) Retrieve the setup-admin API Key

In order to authenticate on KAWA via the Python client, it is recommended to use your API Key. In order to do so, login on KAWA with the setup-admin user with the following credentials:

login: [email protected]

password: changeme

From there, generate your API Key.

⚠️ Once the API Key has been generated, it cannot be recovered (KAWA does not store it anywhere). You can always generate a new one if you wish.