A file at /etc/replicated.conf will only be read on initial startup. It will never be written to, and once initial setup is complete and a license is installed, it will never be read again. (There are some exceptions to this rule, like changing the DaemonAuthenticationPassword, but in general it is not recommended to use /etc/replicated.conf after initial install).

These settings are explained in the following table:

Setting

Acceptable Values

Description

BypassPreflightChecks

Boolean true or false

Allows application to start without preflight checks. This setting is optional. The default is false

DaemonAuthenticationType

anonymous or password

Replicated supports anonymous and password protected access.

DaemonAuthenticationPassword

Any string

If DaemonAuthenticationType is set to password this value is required to access the Replicated console.

DaemonToken

Any string

Authentication token used by operators for automating a cluster installation. This setting is optional. If omitted, a random one will be generated.

ImportSettingsFrom

A file location as a string

If your application has any required config settings, you can supply custom values here. Replicated will read these and set them as if the user manually configured it (see below). This setting is optional.

LicenseFileLocation

A file location as a string

This is the location of an installable .rli license file on the host. The license file used with automated installs should not require email activation. This must be an airgap license if installation will use an airgap package.

LicenseBootstrapAirgapPackagePath

A file location as a string

This is the location of the airgap bundle on the host. When set, the automated install will proceed as an airgapped installation. Note that LicenseFileLocation must also be set to the location of the matching airgap license. This setting is optional.

LicenseBootstrapChannelID

A channel ID as a string

This property allows specifying the installation channel for multi-channel licenses. This setting is optional. When omitted and a multi-channel license is used, the release on the default channel will be installed.

LogLevel

['debug', 'info, 'error']

If present, this will set the log level of the Replicated daemon. This setting is optional.

ReleaseSequence

The number of an app release

Pins the application to a release available in the license’s channel, but is overridden by pins made in the vendor console. See Pinning the Release Sequence of an Application. This setting is optional and has to be omitted when LicenseBootstrapAirgapPackagePath is set.

TlsBootstrapType

['server-path', 'self-signed', 'key-cert']

The type of TLS cert the Replicated UI will run with. Use self-signed for a fully automated setup. Use server-path or key-cert to provide a static cert and key for the admin console.

TlsBootstrapHostname

Any string

The hostname to use for the Replicated-UI :8800 console. This setting is required when TlsBootstrapType is set to server-path.

TlsBootstrapCert

string

A PEM encoded certificate file. When TlsBootstrapType is set to server-path, this value should be the location of a file on the host. When set to key-cert, the value should be the certificate in plain text with newlines replaced with \n.

TlsBootstrapKey

string

A PEM encoded private key file. When TlsBootstrapType is set to server-path, this value should be the location of a file on the host. When set to key-cert, the value should be the private key in plain text with newlines replaced with \n.

Configure App Settings Automatically

When your application has a Settings page, you can configure required options automatically by setting
the ImportSettingsFrom field in /etc/replicated.conf. This file is in JSON format and uses the
config_item names from the YAML as keys. For example, if your YAML contained the following config section: