The best way to configure Loupe Server is to use the Loupe Server Administration tool which is installed with Loupe. It provides a GUI for configuring all of the options to set up a server as well as the options stored within the SQL Databases used by Loupe.
Loupe Server looks for a server.config file by default first in the App_Data directory under the web site or windows service and then in the %ProgramData%\Gibraltar\Configuration directory. This is loaded first and then environment variables are applied as an override. This is the configuration file edited by the Loupe Server Administration application.
Environment variables can be used to override individual elements of the Loupe Server configuration in the Server.config or to set all of the configuration options. This is designed so Loupe can support deployment in scenarios that don't allow configuration files - like Docker Containers and Azure App Services. Each configuration section has a prefix before each configuration item.
| Section | Description |
| Configures a connection with a SMTP server so the Loupe Server can send email. | |
| multitenant | Configures the connection to the SQL database used for the Loupe Cluster |
| queue | Configures the optional Azure Service Bus queue integration |
| search | Configures the optional Elasticsearch integration |
| site | Configures the API endpoint used for Loupe so it can be used in configuration instructions and notifications. |
| sqlServerConnector | Configures the connection to the SQL database used for a single Loupe Repository |
| storage | Configures file storage for agent data files sent to the server |
Most sections only apply to either Standard Edition or Enterprise Edition as indicated at the top of their detailed page.