Troubleshooting Guide
Common issues and their solutions. If you can't find your issue here, check the GitHub Issues or join our community discussions.
Installation Issues
Command not found after installation
Solution
Check if Dits is in your PATH:
# Check where dits was installed
which dits
# If not found, add to PATH
export PATH="$HOME/.dits/bin:$PATH"
# Or move to system location (requires sudo)
sudo cp $(which dits) /usr/local/bin/Permission denied during installation
Solution
Use a local installation directory:
# Install to user directory
curl -fsSL https://raw.githubusercontent.com/byronwade/dits/main/install.sh | bash -s -- --prefix ~/.local
# Add to PATH
export PATH="$HOME/.local/bin:$PATH"Rust toolchain not found
For building from source
Install Rust using rustup:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
# Verify installation
rustc --version
cargo --versionGetting More Help
Documentation
Explore comprehensive guides
Community Support
Get help from the community
Debug Information
Collect info for bug reports
dits --version
dits config --list
dits repo-stats
uname -aTelemetry Issues
Check if telemetry is enabled
Telemetry Status
Check your current telemetry settings:
dits telemetry statusThis shows if telemetry is enabled, your anonymized user ID, and when data was last uploaded.
Disable telemetry if needed
Disable Telemetry
To disable telemetry collection:
dits telemetry disableThis immediately stops all telemetry collection and clears any pending data.
Network connectivity issues with telemetry
Offline Mode
If telemetry uploads are failing due to network issues:
- Telemetry data is stored locally until network is available
- Failed uploads are retried automatically on next use
- You can disable telemetry if network issues persist
Debug Mode
For advanced troubleshooting, enable debug logging:
dits config debug.enabled true