This article explains how to configure your on-premise instance of Meisterplan. If you haven’t done so already, configure mpctl (see Installing Meisterplan).

• Displaying All Configuration Properties
• Updating a Configuration Property
• Available Configuration Properties
  • General Properties
  • Mail Server Setup

Displaying All Configuration Properties

1. Open a shell and execute mpctl configure.
2. This will print a list of all configuration variables, their descriptions and current values.
3. You can only use mpctl configure to view the value of a single variable; for example, you can use mpctl configure management.password to view the administrator password.

Updating a Configuration Property

1. In order to update a configuration value, call mpctl configure <variable> <value>; for example, call mpctl configure database.memorylimit 1024m.
2. Restart the application by calling mpctl restart (this is a required step).

Available Configuration Properties

During the installation, you will be prompted to input required configuration variables. Please note that some configuration values are generated during the setup and will not be explicitly prompted while installing. These properties can be shown or changed as described in the section above.

General Properties

Property Key	Required	Default Value	Description
baseurl		http://meisterplan.local	The URL where users can access Meisterplan. If you want to specify a port, please use the "port" property (see below).
ssl		true	Whether Meisterplan is accessible by HTTP (false) or HTTPS (true). Note: it is only possible to disable SSL if you have a reverse proxy (load balancer) in front that performs SSL termination.
port		80	The port where Meisterplan will be available
loadbalancer		false	Set this to true when you run Meisterplan behind a load balancer or reverse proxy. When enabled set the config 'baseurl' to the URL you use to access Meisterplan.
webapp.memorylimit		2048m	Memory allocated to the Meisterplan webserver
database.password		(generated)	Password for the database
database.memorylimit		1024m	Memory allocated to the database service container
database.port		5432	Port where the database service will be available
messagequeue.password		(generated)	Password for the message queue
messagequeue.secret		(generated)	Internal secret of the message queue
management.password		(generated)	Password for administrators.
authentication.public.key		(generated)	Key to validate access tokens—should be a well-formed public key according to the PKCS #8 standard
authentication.private.key		(generated)	Key to generate access tokens—should be a well-formed private key according to the PKCS #1 standard
authentication.rememberme.secret		(generated)	Secret to generate RememberMe cookies
authentication.secret.soap		(generated)	Secret for SOAP authentication
authentication.saml.spentityid		meisterplan.com/saml	Entity ID of the Meisterplan SAML SP
soapgateway.sessionsecret		(generated)	Secret for SOAP v1 session authentication

Mail Server Setup

You can configure the SMTP Server Setup within the application as described in Configure SMTP Server with Meisterplan.