Toolsync

Debugging

Debug errors inside Toolsync or it's plugins.


Logging

All our packages use the same logger library, which is based on pino and debug.

You can configure logging via the LOG_LEVEL or DEBUG environment variables. This helps to better understand what Toolsync is doing, especially when something goes wrong.

$LOG_LEVEL

You can use the LOG_LEVEL environment variable to control how verbose logging should be:

LOG_LEVEL=debug toolsync ... # Enables debug logging
LOG_LEVEL=trace toolsync ... # Even more logging

The log levels available are: trace, debug, info, warn, error, fatal and silent

$DEBUG

If you want more granular debug logs use DEBUG instead

DEBUG=toolsync:* toolsync ... # Same as using `LOG_LEVEL=debug`
DEBUG=toolsync:cli:* toolsync ... # Enable debug logging just for the cli package
DEBUG=*:timing toolsync ... # Log timing

Found an issue? Have a suggestion? Open an issue on GitHub ✨.

On this page


Edit this page on GitHub

Last modified: 2025-12-12