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 --version

Getting 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 -a

Telemetry Issues

Check if telemetry is enabled

Telemetry Status

Check your current telemetry settings:

dits telemetry status

This 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 disable

This 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