### How to set up your Plaxis integration
For one to be able to run Plaxis through this application requires setting up a Plaxis integration. Here are the steps 
required to do so if you have not yet done so:
#### 1. Requirements
Make sure to have the following software installed:
- [Python 3.11](https://www.python.org/downloads/release/python-3119/)
- Plaxis 2D

Once you have Python 3.11 installed, open Windows Powershell to run the following command:

```shell
pip install plxscripting
```

#### 2. Install and set up Plaxis integration
For the app to be able to connect and communicate with your locally installed Plaxis 2D software, you will require to 
have a Plaxis integration installed and running on your device. Here are the steps to set this up (for more info, refer 
to the [VIKTOR documentation](https://docs.viktor.ai/docs/worker/#installation):
1. Navigate to your profile icon in the right-top corner, and click on **"Settings"**

![Dropdown when clicking on profile icon in the right-top corner](../../assets/settings-dropdown.png)
2. Navigate to the "My integrations" tab, and click on the 
**"Add integration"** button if there is no Plaxis integration type in the list. If a Plaxis integration type already 
exists in the list of available integrations, this means that an integration was already set up in the past. Please 
check that a Plaxis integration exists on your device. If not, remove the existing Plaxis integration by using the 3 
dot under the Actions column to delete the existing integration before continuing.

![An overview of all the personal integrations that have been set up on your profile](../../assets/integration-list.png)
3. Select the Plaxis integration in the list of integrations.

![An overview of the type of dedicated integrations available to choose from](../../assets/integration-options.png)
4. **Download the installation file to install** the integration. 
Once this has been done, **install the integration**, and follow the instructions as you continue the installation. In 
those steps to install the integration, you will be asked to enter a **connection key** and **Python path**. The 
connection key can be retrieved in the last step in the browser steps, which can be copied into the field in the steps.
5. With the Plaxis integration installed, you can start up the integration. This will establish a connection with the 
VIKTOR platform. You will be able to see a green dot next to the integration icon if the integration connection is 
established successfully.

![The integration logo indicating that the integrations set up are all connected](../../assets/integration-logo.png)