# Setup Portal

## Requirements

See the [Requirements](/UDiTH%20Portal/Requirements) page for the Portal (Windows) requirements.

## Installation

We recommend using a guided installation with CAXperts for UDiTH Portal. Please contact support@caxperts.com for information.

Before starting the installation, ensure that all requirements are fulfilled and all prerequisites are installed.

![Start](media/PortalInstallation_01_start.png)

To continue with the installation, accept the EULA and click **Next**.

![EULA](media/PortalInstallation_02_eula.png)

Enter the Keycloak information, such as the URL, admin account, and password. The realm name can be chosen according to your preference.

![Keycloak](media/PortalInstallation_03_keycloak.png)

Choose a suitable installation path and click **Next**.

![InstallPath](media/PortalInstallation_04_installpath.png)

Enter the licence key provided to you, together with a client description, and click **Next**.

![License](media/PortalInstallation_05_license.png)

Select which IIS website to use.

![IISWebsite](media/PortalInstallation_06_IISWebsite.png)

The only setting that needs to be changed is the **Hostname**. This should be `https://<alias/(sub)domain>/Portal`.
Ensure that this matches the certificate.

![IISWebsiteSettings](media/PortalInstallation_07_IISWebsiteSettings.png)

Configure the STUN/TURN server that you want to use. You can leave the default setting if BBV will not be used.

![STUN/TURN Setup](media/PortalInstallation_08_turn.png)

Enter the details of the MSSQL database. An `sa` user is not required. You only need a database together with a database owner user for the database that is to be used.

![Database Login](media/PortalInstallation_09_database.png)

Please specify the location of the folders to be used for the Central Model Repository:

- **Import folder** — Temporary location where model ZIP files are placed for import. Files are removed from this folder after a successful import.
- **Storage folder** — Permanent location where imported models are stored and served from. This folder grows over time and should have sufficient disk space.

![CMR Model Folder](media/PortalInstallation_10_cmr.png)

Click **Install** to start the installation.

![Ready to install](media/PortalInstallation_11_readytoinstall.png)

## Accessing Portal

Go to the Keycloak installation and update the `defaultadmin` password in the realm you specified.
Then go to `https://<alias/(sub)domain>/Portal` and sign in by using `defaultadmin` and the password you defined.

You can add additional users through the web interface or connect the portal to an SSO provider.

![Keycloak Login](media/Portal_Login.png)

## Configuration

On Windows, Portal settings are stored in the `Settings/sharedsettings.json` file inside the installation directory.

For the complete list of available settings, and details on how to provide them, see the [Portal Configuration](/UDiTH%20Portal/Portal%20Configuration) page.

## Security

As with any web server, it should be kept up to date with the latest security fixes.

Switch off outdated or insecure legacy TLS protocols.