# Server Configuration

## Overview

This chapter will describe how to configure the Servoy Application Server.

Most of the settings of the Servoy Application Server can be managed through the [Servoy Admin Page](#servoy-admin-page), some require the editing of configuration files. But when generating the WAR you can specify a servoy.properties file that you want to use, its better to configure everything you need there and don't change it to the adminpage. Changes in the admin page are stored in the {user.dir}/.servoy/server directory so the next time even after deploy it will pick those changes up. This can sometimes lead to weird configuration when deploying a new WAR and you expect that new properties are then used. (you can define at export what you really want, which version should be used, else you need to delete that {user.dir} file)

## Pre-deployment

### servoy.properties file

servoy.properties file is a configuration file used in Servoy and it contains various settings and configurations that define the behavior of the Servoy application server and the deployed applications. The file is located in `{servoyInstall}/application_server`.

{% hint style="danger" %}
**Manual editing of the servoy.properties file**\
It is possible to edit the servoy.properties file by hand, using a text editor. Do make sure to shut down the Servoy Application Server prior to editing. Otherwise, the changes will be overwritten when shutting down or restarting the Servoy Application Server.
{% endhint %}

The `servoy.properties` file also supports property value substitution, so a property of servoy: `servoy.property=value` can also be set like: `servoy.property=${value}`; that value can be then another property value but also a system.property or an environment property.

This way you can provision the properties from the outside (like a docker image)

## Post-deployment changes

### Servoy Admin Page

NOTE: try to avoid making configuration changes through this interface. WAR deployement should get a properties by creation and can use system or environment properties to set specific test or production stuff.

The Servoy Admin page is a browser-based interface to manage a Servoy Application Server.\
The [Servoy Admin Page](#servoy-admin-page) can be accessed using a browser at the following url: `{serverURL}/servoy-admin`. The first page shows the Servoy Application Server status and [Servoy Settings](https://docs.servoy.com/guides/deploy/server-settings#overview).

All the settings done through the Servoy Admin Page are stored in the `servoy.properties` file, located in `{servoyInstall}/application_server`.

Among other things, it allows the server administrator to:

* [Manage Server Settings](https://docs.servoy.com/guides/deploy/server-settings#overview)
* [Manage Server Plugins](https://docs.servoy.com/guides/deploy/server-plugins#overview)
* [Manage Database Servers](https://docs.servoy.com/guides/deploy/database-servers#overview)
* [Manage Client Sessions](https://docs.servoy.com/guides/deploy/client-sessions#client-sessions)
* [Manage Batch Processors](https://docs.servoy.com/guides/deploy/batch-processors#overview)
* [Manage Licenses](https://docs.servoy.com/guides/deploy/license-management#overview)
* [Monitor](https://docs.servoy.com/guides/deploy/monitoring#monitoring)

The Servoy Admin page can be accessed through a browser from the following URL: `{serverUrl}/servoy-admin`

For an indepth overview of all configuration options on the Servoy admin pages, see [Configuring the Server](#server-configuration).