Skip to content

Latest commit

 

History

History
67 lines (43 loc) · 2.08 KB

hosting.rst

File metadata and controls

67 lines (43 loc) · 2.08 KB
Raw

Configure http and https

You can enable http and/or https and adjust the port numbers for them in :ref:`configure_appsettings`.

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 :ref:`configure_change_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.