Loading

Help documentation

Configuring SSL Access

You can turn on Jetty's SSL listener for HTTPS access by configuring a few properties in mingle.properties as follows:

-Dmingle.ssl.port=8443
-Dmingle.ssl.keystore=/PATH/TO/KEYSTORE
-Dmingle.ssl.keystorePassword=PASSWORD_TO_ACCESS_KEYSTORE
-Dmingle.ssl.keyPassword=KEY_PASSPHRASE

You can have both HTTP and HTTPS enabled for Mingle by setting proper values for both the -Dmingle.port property and the entire -Dmingle.ssl.* section.

You can disable HTTP or HTTPS by not setting either of -Dmingle.port or -Dmingle.ssl.port.

If neither -Dmingle.port nor -Dmingle.ssl.port is given, a default of "8080" for -Dmingle.port will be used.

Your keystore (mingle.ssl.keystore) is a file in which keys and certificates are stored. Mingle requires access to it to provide secure HTTPS connections. Your certificate will need to be imported into this keystore. You can find more information on creating and managing a keystore here.

We recommend storing your keystore in a directory outside of Mingle's install folder so that the keystore does not need to be moved during subsequent Mingle upgrades.

Your keystore file is password protected, so you need to provide your keystore password as mingle.ssl.keystorePassword.

The mingle.ssl.keyPassword entry should contain your key's password.

These properties are only used to configure the SSL port to which Mingle binds on its host machine. Be sure to also configure -Dmingle.siteURL (see advanced configuration) to match the new HTTPS URL.