You can set any settings value via an environment variable when starting your server. You will only have to know the setting id and what type of setting it is (boolean, string, integer, etc...).
Name | Data Type |
---|---|
_id | SettingId = string |
type | | 'boolean'| 'timezone'| 'string'| 'relativeUrl'| 'password'| 'int'| 'select'| 'multiSelect'| 'language'| 'color'| 'font'| 'code'| 'action'| 'asset'| 'roomPick'| 'group'| 'date'; |
public | boolean |
env | boolean |
group(Optional) | GroupId = SettingId |
section(Optional) | SectionName = string |
tab(Optional) | TabId = SettingId |
i18nLabel | string |
value | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
packageValue | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
blocked | boolean |
enableQuery(Optional) | string |
displayQuery(Optional) | string |
sorter | number |
properties(Optional) | unknown |
enterprise(Optional) | boolean |
requiredOnWizard(Optional) | boolean |
hidden(Optional) | boolean |
modules(Optional) | Array |
invalidValue(Optional) | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
valueSource(Optional) | string |
secret(Optional) | boolean |
i18nDescription (Optional) | string |
autocomplete(Optional) | boolean |
processEnvValue(Optional) | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
meteorSettingsValue(Optional) | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
ts | Date |
createdAt | Date |
_updatedAt(Optional) | Date |
multiline(Optional) | boolean |
values(Optional) | Array |
placeholder(Optional) | string |
wizard(Optional) | step: order: |
persistent(Optional) | boolean |
readonly(Optional) | boolean |
alert(Optional) | string |
private (Optional) | boolean |
Name | Data Type |
---|---|
_id | string |
hidden | boolean |
blocked | boolean |
ts | Date |
sorter | number |
i18nLabel | string |
displayQuery | string |
i18nDescription | string |
value | undefined |
type | group |
alert | string |
Name | Data Type |
---|---|
enterprise | true |
invalidValue | SettingValue = string | boolean | number | SettingValueMultiSelect | Date | AssetValue | undefined; |
Name | Data Type |
---|---|
type | color |
editor | SettingEditor |
packageEditor(Optional) | SettingEditor |
Name | Data Type |
---|---|
type | action |
value | string |
actionText(Optional) | string |
Name | Data Type |
---|---|
type | action |
value | string |
actionText(Optional) | string |
Name | Data Type |
---|---|
type | asset |
value | AssetValue |
fileConstraints | IRocketChatAssetConstraint |
asset | string |
Name | Data Type |
---|---|
key | string | number; |
i18nLabel | string |
Name | Data Type |
---|---|
COLOR | color |
EXPRESSION | expression |
Name | Data Type |
---|---|
type | date |
value | Date |
Name | Data Type |
---|---|
account2fa(Optional) | boolean |
cannedResponsesEnabled (Optional) | boolean |
e2e (Optional) | boolean |
e2eDefaultDirectRoom(Optional) | boolean |
e2eDefaultPrivateRoom(Optional) | boolean |
smtpHost(Optional) | string |
smtpPort(Optional) | string |
fromEmail(Optional) | string |
fileUploadEnable(Optional) | boolean |
frameworkDevMode(Optional) | boolean |
frameworkEnable(Optional) | boolean |
surveyEnabled(Optional) | boolean |
updateChecker(Optional) | boolean |
liveStream(Optional) | boolean |
broadcasting(Optional) | boolean |
allowEditing(Optional) | boolean |
allowDeleting(Optional) | boolean |
allowUnrecognizedSlashCommand(Optional) | boolean |
allowBadWordsFilter(Optional) | boolean |
readReceiptEnabled(Optional) | boolean |
readReceiptStoreUsers(Optional) | boolean |
otrEnable(Optional) | boolean |
pushEnable(Optional) | boolean |
globalSearchEnabled(Optional) | boolean |
threadsEnabled(Optional) | boolean |
bigBlueButton(Optional) | boolean |
jitsiEnabled(Optional) | boolean |
webRTCEnableChannel(Optional) | boolean |
webRTCEnablePrivate(Optional) | boolean |
webRTCEnableDirect(Optional) | boolean |
To set a setting for the first time you need only to add the env var SETTING_ID=VALUE
when starting the server.
Example:
FileUpload_Storage_Type=GoogleCloudStorage
Note: This only works if the setting isn't already set. So this is most useful for setting on initial start. If the setting already has a value you will need to use the syntax below
You can overwrite any setting by setting an environment variable prefixed with: OVERWRITE_SETTING_
Example:
OVERWRITE_SETTING_FileUpload_Storage_Type=GoogleCloudStorage
You can block a setting from being changed by specifying the SETTINGS_BLOCKED
environment variable. This is a comma separated list. Any setting you want to block you need to add to this list.
Example:
SETTINGS_BLOCKED=FileUpload_Storage_Type,FileUpload_GoogleStorage_AccessId,FileUpload_GoogleStorage_Secret
Even you as an admin will not be able to change this via the UI. If you want to change the setting you will need to remove it from the list and reboot the server
Example:
You can hide settings from the client by using the SETTINGS_HIDDEN
environment variable
SETTINGS_HIDDEN=FileUpload_GoogleStorage_AccessId,FileUpload_GoogleStorage_Secret
Be careful with this setting some settings like FileUpload_Storage_Type
are needed by the client so cannot be hidden
Example:
You can force settings to be required on wizard pages by using the SETTINGS_REQUIRED_ON_WIZARD
environment variable
SETTINGS_REQUIRED_ON_WIZARD=Organization_Type,Organization_Name