Configure http and https

You can enable http and/or https and adjust the port numbers of Firely Server as described below.

Changing the port number

By default Firely Server will run on port 4080 of your system. You can change the port setting by overriding it as described in Changing the settings:

  • Navigate to your Firely Server working directory

  • Find this setting:

    "Hosting": {
        "HttpPort": 4080
}

  • Change the number to the port number you want

Changing from http to https

If you need your server to run on https instead of http, follow these steps:

  • Navigate to the location where you extracted the Firely Server files.

  • Find these settings:

"Hosting": {
        "HttpPort": 4080,
        "HttpsPort": 4081, // Enable this to use https
        "CertificateFile": "<your-certificate-file>.pfx", //Relevant when HttpsPort is present
        "CertificatePassword" : "<cert-pass>" // Relevant when HttpsPort is present
},

  • Uncomment the lines for HttpsPort, CertificateFile and CertificatePassword.

  • Set the HttpsPort to the port of your liking (standard https port is 443)

  • Set CertificateFile to the location of the .pfx file that contains the certificate for your site

  • Set CertificatePassword to the password for the certificate file.

Note

We recommend setting this value as an environment variable for security reasons:

VONK_Hosting:CertificatePassword=<password>

To set this:

  • In Powershell run:
    > $env:VONK_Hosting:CertificatePassword="my_password"
    where my_password is the password for the .pfx file

  • or go to your System, open the Advanced system settings –> Environment variables and create a new variable with the name VONK_Hosting:CertificatePassword and the value set to your password

  • You can choose to comment-out the HttpPort setting, so Firely Server will no longer be available through unsecured http.