Installation¶

This guide will help you install Capsula on your system.

Requirements¶

• Rust toolchain (version 1.90.0 or later)

Installing Capsula¶

Method 1: Install from crates.io (Recommended)¶

This is the easiest way to install Capsula:

cargo install capsula-cli --locked

This downloads and compiles the latest stable version from Rust's package registry.

Method 2: Install from GitHub¶

To install the latest development version:

cargo install --git https://github.com/ut-issl/capsula --locked capsula-cli

Verify Installation¶

After installation, verify that Capsula is working:

capsula --version

You should see output like:

capsula 0.9.0

Try the help command:

capsula --help

Updating Capsula¶

To update Capsula to the latest version, run the same install command again:

cargo install capsula-cli --locked

Cargo will automatically download and install the new version.

Troubleshooting¶

"cargo: command not found"¶

Rust is not installed or not in your PATH. Install Rust from rustup.rs and restart your terminal.

Compilation Errors¶

Rust version too old:

Check your Rust version:

rustc --version

Capsula requires Rust 1.90.0 or later. Update Rust:

rustup update

Then try installing again:

cargo install capsula-cli --locked

Missing system libraries:

If compilation fails with "linker" or "library not found" errors, you may need to install system development libraries. Read the error output carefully - it usually indicates which library is missing.

Uninstalling Capsula¶

If you need to uninstall Capsula:

cargo uninstall capsula-cli

This removes the Capsula binary but doesn't delete any captured data in your .capsula directories.