Installation

There are several ways to install Comtrya on a system: cargo, shell script, provided binaries, or package managers. Comtrya can also be built from source.

Cargo installation

If your system has the Rust programming language tools such as cargo installed, cargo can be used to fetch the source and build a binary on your machine, placing it in location accessible by your path environment variable. First, ensure that the Rust programming language tool is installed by running the following:

cargo --version

You should see the version of cargo installed on your system printed out. If you get an error or nothing, please get the Rust tooling from the Rust Website if you want to build from source.

Once you have cargo and rustc on your system, you can fetch the sources and build with the following command:

cargo install comtrya

Shell Script

A script downloads a pre-compiled comtrya binary from the releases and installs it. It verifies the binary's SHA-256 checksum where the release has one (releases since mid-2025).

On Linux (x86_64, aarch64) and macOS:

curl -fsSL https://comtrya.dev/install.sh | sh

It installs to /usr/local/bin and asks for sudo if that isn't writable. To pin a version or install somewhere else:

curl -fsSL https://comtrya.dev/install.sh | VERSION=v0.11.0 INSTALL_DIR="$HOME/.local/bin" sh

On Windows, in PowerShell:

irm https://comtrya.dev/install.ps1 | iex

It installs comtrya.exe to %USERPROFILE%\.comtrya and adds that folder to your user PATH. $env:VERSION and $env:INSTALL_DIR work as above.

The scripts live in the repository as docs/src/install.sh and docs/src/install.ps1, so you can read them before running them.

Precompiled-binaries

Pre-compiled binaries are also included on our GitHub repository under our releases.

Package managers

Some package managers may provide comtrya. Check with yours. At the time of writing this, comtrya is available in the Arch User Repository (AUR), Homebrew and Ravenports. If you are interested in packaging comtrya for another ports or packaging system, feel free to reach out to the team by opening an issue on our GitHub for support.

Building from source

Building from source should be a straight forward task for anyone familiar with the Rust toolchian. It is recommended that you read through the cargo book and get familiar with it. Once you are, building is a matter of simply cloning our repository and compiling it. However, it is important to note that you may need to ensure you have the development libraries for openssl installed on your system. Check with your operating system and package manager what these packages are as they can often vary in naming between different systems.