Debug Logging

By default, Talemate logs at the INFO level. To enable more verbose DEBUG logging, set the TALEMATE_DEBUG environment variable to 1 before starting the server.

This will output detailed debug information from all components, which is useful for troubleshooting issues or reporting bugs.

When debug mode is enabled, all errors are automatically logged to a file at logs/errors.log in the Talemate root directory. The log file uses a rotating file handler with a maximum size of 10MB and keeps up to 5 backup files.

Linux

Prefix the start command with the environment variable:

TALEMATE_DEBUG=1 ./start.sh

Or if running manually:

TALEMATE_DEBUG=1 uv run src/talemate/server/run.py runserver --host 0.0.0.0 --port 5050

Windows

Set the environment variable before running the start script:

SET TALEMATE_DEBUG=1
start.bat

Disabling debug logging

To return to normal logging, unset the variable or set it to 0:

Linux

unset TALEMATE_DEBUG

Or simply run without the prefix:

./start.sh

Windows

SET TALEMATE_DEBUG=0
start.bat