Bit has tools to help you troubleshoot common errors during setup and usage of Bit
bit doctor is a self diagnosis and healing tool for Bit workspaces.
Running diagnosis on workspaces
Starting from version
14.1.0 Bit features a self diagnosis and healing tool call
bit doctor. Run this command in case you encounter blocking issues in your workspace.
The output is a list of all diagnosis that Bit currently implements. If any of the checks has failed, Bit suggests a fix for it.
At some cases the maintainers will require additional workspace information in order to debug an issue. Doctor is capable of saving the most important data and logs from the workspace in a shareable format.
Use this file when opening an issue to the project repository.
Note, before submitting the output you can open it an validate that no sensitive information is submitted. You can clear such information from the file.
bit doctor --save doctor-results
Some errors and additional information are document in Bit's log files but not displayed in the console output. If you're having problems, it's worth checking the log files.
Bit's log files are stored in:
- For Mac/Linux -
- For Windows -
%LOCALAPPDATA%is not defined, user profile directory will be used instead of
%LOCALAPPDATA%. Further fallback options are available here.
There are three different log types:
- Debug log -
- Exceptions log -
- Extensions log -
Each log file's size can be maximum 10MB, and there can be maximum 10 log files of each type. They will be numbered as follows:
The log files are actually winston logs, and are tailable.
If errors occur, it is worth trying to clear Bit's cache in case it got corrupted. You can clear it using the clear cache command: