COOLCONFIG(1)

💖 coolconfig — the Collabora Online config bestie 💖

okay bestie, you're reading the COOLCONFIG(1) manual, aka the User Commands corner of the Unix universe, and this page is literally all about coolconfig. 💅✨

🌸 NAME 🌸

coolconfig — the configuration tool for Collabora Online. 🎀

🦋 SYNOPSIS 🦋

coolconfig COMMAND [OPTIONS]

🎀 COMMANDS AND OPTIONS 🎀

🌈 General options 🌈

• -h, --help — shows this usage information, like a little “here’s how to use me” moment. 🫶
• --config-file=path — manually sets the configuration file path. The default is usually /etc/coolwsd/coolwsd.xml. 📁

🧚 anonymize 🧚

okay so anonymize is your log-reading helper. 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 you get the anonymized hash — that’s the thing you use to search the logs with. 🔍💖

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

• --anonymization-salt=salt — anonymizes strings with the given 64-bit salt instead of the one in the config file. 🧂✨

🦋 migrateconfig 🦋

migrateconfig is the glow-up command that migrates the 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 — manually specifies the file path for the old configuration. The default is /etc/loolwsd/loolwsd.xml. 📜
• --write — writes the 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:

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 👑

set-admin-password 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. 🔐
• --user=name — user name for the admin console. If unspecified, it will be requested on the terminal. 🙋
• --password=password — password for the admin console. If unspecified, it will be requested on the terminal. 🤫

🎨 update-system-template 🎨

update-system-template 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 🗝️

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

generate-proof-key

💜 SEE ALSO 💜

• coolforkit-ns(1)
• coolconvert(1)
• coolwsd(1)
• coolwsd-systemplate-setup(1)

---

this page comes from coolconfig, dated Jul 2023, and the manual is COOLCONFIG(1) — bye bestie, go config slay 💅✨