bindings

Web server endpoints that the Web Administration interface listens on. By default, the server listens on localhost:8880 for HTTP requests.

We strongly recommend using HTTPS for any endpoint accessible over the network. HTTP should only be used for localhost access.

bindings:
  # HTTP on localhost (default)
  - hostname: localhost
    port: 8880

  # HTTPS with certificate from file
  - hostname: 192.168.1.212
    port: 443
    certificateFromFile:
      filePath: 'C:\cert.pfx'
      password: "secretPasswordForCertificate"

  # HTTPS with certificate from Windows certificate store
  - hostname: wa.mydomain.com
    port: 443
    certificateFromStore:
      storeName: My
      thumbprint: 92e50cdfeab5c164f32148117878fe4e7d7bc2c

bindings[].hostname

string

IP address or hostname to listen on. Use 0.0.0.0 to listen on any IPv4 address and :: on any IPv6 address. Hostnames are resolved when the server starts.

bindings[].port

number = 8880

Port number to listen on for HTTP or HTTPS requests.

bindings[].certificateFromFile

object

Load an HTTPS certificate from a .pfx (PKCS#12) file. When specified, the endpoint uses HTTPS.

bindings[].certificateFromFile.filePath

string

File path to the .pfx (PKCS#12) certificate with private key.

bindings[].certificateFromFile.password

string

Password for the certificate's private key.

bindings[].certificateFromStore

object

Load an HTTPS certificate from the Windows certificate store. When specified, the endpoint uses HTTPS.

bindings[].certificateFromStore.storeName

string

Local Computer certificate store name, e.g. My (Personal), Root, CA, WebHosting. User certificates are not currently supported.

bindings[].certificateFromStore.thumbprint

string

Certificate thumbprint. The certificate must have Server authentication capability and an exportable private key.

On this page