Installation

Dits can be installed on macOS, Linux, and Windows. Choose the installation method that works best for your workflow.

Quick Install

The fastest way to install Dits is via npm, which works on all platforms and automatically downloads the correct binary for your system.

# npm
npm install -g @byronwade/dits

# bun
bun install -g @byronwade/dits

# pnpm
pnpm install -g @byronwade/dits

System Requirements

Verify Installation

After installation, verify that Dits is working correctly:

$ dits --version
dits 0.1.2

$ dits --help
Dits - Distributed version control for video and large files

Usage: dits <COMMAND>

Commands:
  init      Create a new repository
  clone     Clone a repository
  status    Show repository status
  add       Add files to staging
  commit    Create a commit
  ...

Installing FUSE (Optional)

FUSE is only required if you want to use the Virtual Filesystem feature, which allows you to mount repositories as drives without downloading all files.

brew install macfuse

Troubleshooting

Command not found

If you get a "command not found" error after installation, ensure that the installation directory is in your PATH:

# For npm global installs, add to your shell profile:
export PATH="$PATH:$(npm config get prefix)/bin"

# For cargo installs:
export PATH="$PATH:$HOME/.cargo/bin"

Permission denied

On macOS or Linux, if you get permission errors with the curl installer:

# Install to a local directory
curl -fsSL https://raw.githubusercontent.com/byronwade/dits/main/install.sh | sh -s -- --prefix=$HOME/.local

SSL/TLS errors

If you encounter SSL certificate errors, ensure your system's CA certificates are up to date:

# macOS
brew install ca-certificates

# Ubuntu/Debian
sudo apt update && sudo apt install ca-certificates

Next Steps

• Follow the Quick Start Guide to create your first repository
• Learn about Core Concepts
• Explore the CLI Reference