SD Debug Log

The device can write a rolling debug log to the SD card for troubleshooting. This is found under Status → System Diagnostics, just below the restart/reset info.

This is a separate feature from the Logger Settings tab, which controls the OBD/PID vehicle-data logger (obd_logs/*.db). The SD Debug Log captures general system debug output instead, and the two happen to share the word "logger" but are otherwise unrelated.

Settings

SD Debug Log (Enable/Disable) Turns logging on or off. Writes to /sdcard/wican.log. The log rotates automatically at 1MB, keeping one backup copy (wican.log.1) so it never fills the card. Requires a reboot to take effect after changing this setting.

Setting this to Disable deletes the existing log files (wican.log and wican.log.1) on the next reboot — it doesn't just stop future writes. If you want to keep a copy, download it before disabling.

Download Debug Log Downloads the current wican.log file as a plain text file you can open or share for troubleshooting.

Viewing the log from the web terminal

You can also peek at the log directly in the device's web terminal, without downloading anything:

• sdcard -l (or sdcard --log, or sdcard --tail) — prints the newest 8 KiB of the log
• sdcard -p <N> — prints a specific page of the log, for stepping back further than the tail

This is handy for a quick look at recent activity; use the Download button when you want the complete file. Note that if SD Debug Log is set to Disable, the log file is deleted, so these commands will have nothing to show until logging is re-enabled.

The redaction described below applies here too — secrets are removed before lines are ever written to the file, so the terminal view is just as safe as the downloaded copy.

What's in the log

Every system log message the device produces — WiFi, MQTT, VPN, AutoPID, etc. — since logging was last enabled.

Privacy

Known sensitive values (WiFi/MQTT/VPN passwords, keys, tokens) are automatically redacted before being written to the log, so it's safe to share for support purposes. Non-sensitive values like IP addresses, SSIDs, and usernames are left visible, since they're often needed to diagnose network issues.

Even so, always review the log yourself before posting it anywhere public (Discord, GitHub issues, forums, etc.). Redaction covers known fields, but it can't guarantee every possible sensitive value is caught — things like your VPN endpoint IP, custom webhook URLs, or anything unexpected in a vehicle profile name could still be present. Skim the file and remove/black out anything you don't want visible before sharing it with anyone.

Limitations

• Only the current log file downloads — the rotated backup (wican.log.1) isn't accessible from the web UI yet.
• There's currently no dedicated "delete now" button in the web UI — deletion only happens as a side effect of disabling logging and rebooting (see above).