# Configuring Screena Portal

{% hint style="info" %}
Please follow the steps to install Screena Portal in this order:

1. [Preparing your system](/resources/how-to/install-screena-portal/preparing-your-system.md)
2. [Installing Screena Portal backend](/resources/how-to/install-screena-portal/installing-screena-portal-backend.md)
3. [Launching Screena Portal backend](/resources/how-to/install-screena-portal/launching-screena-portal-backend.md)
4. [Installing the web server](/resources/how-to/install-screena-portal/installing-the-web-server.md)
5. [**Configuring Screena Portal**](/resources/how-to/install-screena-portal/configuring-screena-portal.md) **(you are here)**
   {% endhint %}

The Screena Portal uses 3 properties files to configure various settings. These files are:

* [apigw.properties](#apigw.properties)
* [application.properties](#application.properties)
* [smtp.properties](#smtp.properties)

## apigw\.properties

This file contains the connection parameters to the Screena server. It should be configured to match your system's settings.

| Property                          | Description                                                |
| --------------------------------- | ---------------------------------------------------------- |
| screena.base.server               | The URL of the Screena server                              |
| screena.base.port                 | The port of the Screena server                             |
| screena.base.https                | Whether to use HTTPS when connecting to the Screena server |
| apigw\.document.uploaded.basePath | The directory where the uploaded documents will be stored  |
| apigw\.fileDelimiter              | The file delimiter used by the system                      |

## application.properties

This file contains properties to define application-specific settings. It should be configured to match your system's settings.

| Property                   | Description                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------- |
| spring.datasource.url      | The JDBC URL to connect to the database (it specifies the database type, location, port and encoding) |
| spring.datasource.username | The username used to connect to the database                                                          |
| spring.datasource.password | The password used to connect to the database                                                          |

## smtp.properties

This file contains properties to define the SMTP server settings. It should be configured to match your system's SMTP server settings.

| Property                    | Description                                       |
| --------------------------- | ------------------------------------------------- |
| smtp.host                   | The SMTP server hostname                          |
| smtp.port                   | The SMTP server port                              |
| smtp.user                   | The SMTP server username                          |
| smtp.password               | The SMTP server password                          |
| smtp.protocol               | The SMTP protocol to use                          |
| smtp.socketFactory.port     | The SMTP socket factory port                      |
| smtp.auth                   | Whether SMTP authentication is enabled or not     |
| smtp.starttls.enable        | Whether to enable STARTTLS                        |
| smtp.starttls.required      | Whether STARTTLS is required or not               |
| smtp.debug                  | Whether to enable SMTP debugging                  |
| smtp.socketFactory.fallback | Whether to fallback to the socket factory         |
| smtp.from                   | The email address that messages will be sent from |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.screena.ai/resources/how-to/install-screena-portal/configuring-screena-portal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.