usage: coolconfig COMMAND [OPTIONS]
coolconfig - Configuration tool for Collabora Online.

Some options make sense only with a specific command.

Options:

-h, --help                 Show this usage information.
--config-file=path         Specify configuration file path manually.
--old-config-file=path     Specify configuration file path to migrate
                           manually.
--pwd-salt-length=number   Length of the salt to use to hash password
                           [set-admin-password].
--pwd-iterations=number    Number of iterations to do in PKDBF2 password
                           hashing [set-admin-password].
--pwd-hash-length=number   Length of password hash to generate
                           [set-admin-password].
--user=name                Admin user name [set-admin-password].
--password=password        Admin user password [set-admin-password].
--anonymization-salt=salt  Anonymize strings with the given 64-bit salt
                           instead of the one in the config file.
--write                    Write migrated configuration.

Commands:
    migrateconfig [--old-config-file=<path>] [--config-file=<path>] [--write]
        The migrateconfig command migrates config file of Collabora Online 6.4 or older to the new format.
    anonymize [string-1]...[string-n]
    set-admin-password
    set <key> <value>
    generate-proof-key
    update-system-template

sudo -u cool coolconfig set-admin-password --user=admin --password=q1w2e3r4

Saving configuration to : /etc/coolwsd/coolwsd.xml ...
Saved

<username desc="The username of the admin console. Ignored if PAM is enabled.">admin</username>
<secure_password desc="Salt and password hash combination generated using PBKDF2 with SHA512 digest.">pbkdf2.sha512.10000.62c234059c427268b8588e09ed7c8a31f004c22f38a06b7ad94f9ee531eb05fb3867b94033ab710a116935f49b76f4fb74d82872e2b91b8eda4fa4c9c8655d8fe0ca2ee29efbdc0f2cda0d6259a658fd02aa8a8078661c4f108d1498c466fdb438abb8fe5a833d528122bbaa8295bd4e931f21260d96d83e5f1df164a1318e57.830eeb77...</secure_password>

coolconfig set per_document.idle_timeout_secs 1800

Previous value found in config file: "3600"
Changing value to: "1800"
Saving configuration to : /etc/coolwsd/coolwsd.xml ...
Saved

<idle_timeout_secs default="3600" desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint">1800</idle_timeout_secs>

usage: coolwsd OPTIONS
Collabora Online WebSocket server.

--daemon                       Run application as a daemon.
--umask=mask                   Set the daemon's umask (octal, e.g. 027).
--pidfile=path                 Write the process ID of the application to
                               given file.
--help                         Display help information on command line
                               arguments.
--version-hash                 Display product version-hash information and
                               exit.
--version                      Display version and hash information.
--cleanup                      Cleanup jails and other temporary data and
                               exit.
--probe                        Health-check the locally running coolwsd over
                               its configured port and exit 0 if healthy,
                               non-zero otherwise.
--port=port_number             Port number to listen to (default: 9980),
--disable-ssl                  Disable SSL security layer.
--disable-cool-user-checking   Don't check whether coolwsd is running under
                               the user 'cool'.  NOTE: This is insecure, use
                               only when you know what you are doing!
-o xmlpath, --override=xmlpath  Override any setting by providing full
                               xmlpath=value.
--config-file=path             Override configuration file path.
--lo-template-path=path        Override the COKit core installation directory
                               path.
--unattended                   Unattended run, won't wait for a debugger on
                               faulting.
--signal                       Send signal SIGUSR2 to parent process when
                               server is ready to accept connections
--use-env-vars                 Use the environment variables defined on
                               https://sdk.collaboraonline.com/docs/installati
                               n/CODE_Docker_image.html#setting-the-applicatio
                               n-configuration-dynamically-via-environment-vari
                               ables to set options. 'extra_params' is appended
                               to the command line by this option;
                               'DONT_GEN_SSL_CERT' and 'cert_domain' control
                               certificate generation independently of this
                               option.

wsd-05701-05701 2026-10-21 20:46:43.233361 [ coolwsd ] INF  Initializing wsd. Log timestamps are in GMT time. Now: Wed 2026-10-21 20:46:43 +0000. Log level is [8]
wsd-05701-05701 2026-10-21 20:46:43.233407 [ coolwsd ] INF  Setting log-level to [trace] and delaying setting to [warning] until after WSD initialization.
wsd-05701-05701 2026-10-21 20:46:43.233416 [ coolwsd ] INF  Initializing coolwsd 26.04.5.1 server []. Experimental features are enabled.

ExecStart=/usr/bin/coolwsd --version --o:sys_template_path=/opt/cool/systemplate --o:child_root_path=/opt/cool/child-roots --o:file_server_root_path=/usr/share/coolwsd --o:cache_files.path=/opt/cool/cache

coolwsd --version-hash

22ce52fb51

coolwsd --version

Failed to initialize COOLWSD: Do not run as root. Please run as cool user.
Do not run as root. Please run as cool user.

sudo -u cool coolwsd --probe

coolwsd --probe: could not connect to http://127.0.0.1:9980/livez

sudo -u cool coolwsd --o:sys_template_path=/opt/cool/systemplate --o:child_root_path=/opt/cool/child-roots --o:file_server_root_path=/usr/share/coolwsd --o:cache_files.path=/opt/cool/cache --disable-ssl

curl -s -o /dev/null -w "local 9980: HTTP %{http_code}\n" http://127.0.0.1:9980/
curl -s http://127.0.0.1:9980/hosting/capabilities | head -c 120; echo

local 9980: HTTP 200
{"convert-to":{"available":true,"endpoint":"/cool/convert-to"},"hasDocumentSigningSupport":true,"hasMobileSupport":true,

Usage: /usr/bin/coolwsd-systemplate-setup <chroot template directory for system libs to create> <LO installation directory>

sudo coolwsd-systemplate-setup /opt/cool/systemplate-new /opt/collaboraoffice

2668 blocks

ls /opt/cool/systemplate-new

dev  etc  lib  lib64  lo

Collabora Online document converter tool.
Usage: coolconvert [options] file...
Options are:
  --help                      Show this text
  --extension=format          File format to convert to
  --outdir=directory          Output directory for converted files
  --parallelism=threads       Number of simultaneous threads to use
  --server=uri                URI of COOL server
  --no-check-certificate      Disable checking of SSL certificate
In addition, the options taken by the soffice command for its --convert-to
functionality can be used (but are ignored if irrelevant to this command).

printf 'hello from coolconvert\n' > /tmp/cc.txt
coolconvert --extension=pdf --outdir=/tmp --server=http://127.0.0.1:9980 /tmp/cc.txt
ls -la /tmp/cc.pdf

rc=0
-rw-r--r-- 1 cool cool 11660 Oct 21 20:48 /tmp/cc.pdf

Security: coolforkit incorrect user-name, other than 'cool'.
Hint: If you are trying to run Collabora Online locally, you need to be using --enable-debug.
Aborting.

Usage: coolstress wss://localhost:9980 <test-document-path> <trace-path>
       Trace files may be plain text or gzipped (with .gz extension).
       --help for full arguments list.

curl -s http://localhost:9980/hosting/capabilities

{"convert-to":{"available":true,"endpoint":"/cool/convert-to"},"hasDocumentSigningSupport":true,"hasMobileSupport":true,"hasProxyPrefix":false,"hasSettingIframeSupport":true,"hasSlideImportSupport":false,"hasTemplateSaveAs":false,"hasTemplateSource":true,"hasWASMSupport":false,"hasWopiAccessCheck":true,"hasZoteroSupport":true,"productKitVersion":"26.04.5.1","productKitVersionHash":"22ce52fb","productName":"Collabora Online Development Edition","productVersion":"26.04.5.1","productVersionHash":"22ce52fb51","serverId":"A6C5BEA7"}

curl -sI http://localhost:9980/hosting/discovery | head -6

HTTP/1.1 200 OK
Date: Wed, 21 Oct 2026 20:27:51
Server:
Content-Length: 44048
Content-Type: text/xml
Last-Modified: Wed, 21 Oct 2026 20:27:51

<app favIconUrl="https://office.example.com/browser/22ce52fb51/images/x-office-document.svg" name="writer">
    <action default="true" ext="odt" name="edit" urlsrc="https://office.example.com/browser/22ce52fb51/cool.html?"/>

curl -s -o /dev/null -w "livez: HTTP %{http_code}\n" http://localhost:9980/livez
curl -s -o /dev/null -w "web:   HTTP %{http_code}\n" http://localhost:9980/

livez: HTTP 200
web:   HTTP 200

printf 'hello rest\n' > /tmp/t.txt
curl -s -F "data=@/tmp/t.txt;filename=t.txt" http://localhost:9980/cool/convert-to/pdf -o /tmp/t.pdf -w "HTTP %{http_code}, size %{size_download}\n"

HTTP 200, size 11449

# 服务状态与最近日志
systemctl status coolwsd --no-pager | head -10
journalctl -u coolwsd -n 50 --no-pager

# 启动期配置核对（非默认值 dump，见配置篇 3.3 节）
journalctl -u coolwsd --no-pager | grep -A30 'non-default values'

# 打开文件日志后的跟踪（logging.file.enable=true 时）
tail -f /var/log/coolwsd.log

● coolwsd.service - Collabora Online WebSocket Daemon
     Loaded: loaded (/lib/systemd/system/coolwsd.service; enabled; vendor preset: enabled)
     Active: active (running)
   Main PID: 1234 (coolwsd)