coolconfig(1)

COOLCONFIG(1) User Commands COOLCONFIG(1)

NAME

coolconfig - Configuration tool for Collabora Online.

SYNOPSIS

coolconfig COMMAND [OPTIONS]

COMMANDS AND OPTIONS

General options:

-h, --help Show this usage information.

--config-file=path Specify configuration file path manually. The default is usually /etc/coolwsd/coolwsd.xml.

anonymize

The anonymize command helps to read anonymized logs. If you know a document and/or a user had an issue, you can find their session in the logs by running this command with the username and/or document name and get the anonymized hash, which you use to search the logs with.

anonymize [string-1]...[string-n]

--anonymization-salt=salt Anonymize strings with the given 64-bit salt instead of the one in the config file.

migrateconfig

The migrateconfig command migrates config file of Collabora Online 6.4 or older to the new format.

migrateconfig [--old-config-file=<path>] [--config-file=<path>] [--write]

--old-config-file=path Specify file path for the old configuration manually. The default is /etc/loolwsd/loolwsd.xml.

--write Write migrated configuration. Without this option no changes are written to the config file, only information about differences between old and new config is printed.

Example: coolconfig migrateconfig --old-config-file=/etc/loolwsd/loolwsd.xml --config-file=/etc/coolwsd/coolwsd.xml --write

set

The set command changes an existing configuration setting in the config file. The <key> is the XPath expression of the config item in the config XML file (coolwsd.xml).

set <key> <value>

Example: coolconfig set logging.level trace

set-admin-password

The set-admin-password command sets the user name and password of the administrator who can access Collabora Online's admin console.

set-admin-password

--pwd-salt-length=number Length of the salt to use to hash password.

--pwd-iterations=number Number of iterations to do in PKDBF2 password hashing.

--pwd-hash-length=number Length of password hash to generate.

update-system-template

The update-system-template command updates Collabora Online's system template. It is used typically when new fonts are added to the system, that need to be used with Collabora Online.

update-system-template

generate-proof-key

The generate-proof-key command creates an RSA key pair in /etc/coolwsd for the WOPI Proof headers. The postinstall script of coolwsd package usually creates this RSA key pair in case of new installation.

SEE ALSO

coolforkit(1), coolconvert(1), coolwsd(1), coolwsd-systemplate-setup(1), coolmount(1)

Jul 2023 coolconfig