A script that collects a redacted debug bundle for bug reports
One command packs a misbehaving player's logs and system details into a single archive to attach to a GitHub issue or forum post, with IP addresses, passwords and other secrets replaced first.
If your player misbehaves and you ask for help in a GitHub issue or on the forum, the first thing you'll be asked for is logs and system details. From Anthias 2026.07.0, one command gathers them into a single file you can attach, with passwords and IP addresses replaced first. You only need it when you're reporting a problem.
The command is bin/collect_debug.sh, in the repository.
On a player installed with the installer, run:
~/anthias/bin/collect_debug.sh
It writes anthias-debug-<date>-<time>.tar.gz to your home directory. The archive holds:
- host and system details, and on a Raspberry Pi its throttling status and temperature
- Docker and Compose state, the last 2,000 log lines of each Anthias container, and the kernel log
- the Anthias configuration and an overview of the database
- an
ffprobereport for each video asset - network and Redis checks
Before it packs the archive, the script replaces IP and MAC addresses, email addresses, usernames and passwords inside URLs, and the device's hostname with placeholders, and blanks the passwords, keys and other secrets in anthias.conf. Asset names and addresses can still be in it, so read through the bundle before you post it.
The script only reads from the system, so you can run it while the player is showing content. --output DIR writes the archive somewhere else, --lines N changes how many log lines it keeps per container, and --no-archive leaves the folder unpacked.