Getting Started

Prerequisites

You’ll need at least a C/C++ build environment and clang and curl (for running rustup) installed.

For Ubuntu / Debian:

  apt-get install build-essential libclang-dev curl

For Fedora / RHEL / Rocky / AlmaLinux:

  dnf groupinstall "Development Tools"
  dnf install clang curl

For Arch Linux / Manjaro:

  pacman -S base-devel clang curl

For Alpine Linux:

  apk add build-base clang curl

Then use gem to install Itsi, or its components based on your Ruby version.

For Ruby >= 3.0:

  gem install itsi

(Installs both itsi-server and itsi-scheduler)

For Ruby 2.7:

  gem install itsi-server

(Installs itsi-server only; itsi-scheduler is not supported on Ruby 2.7)

ℹ️ Itsi (server + scheduler) requires Ruby >= 3.0 Itsi server supports Ruby >= 2.7 You can install components individually: gem install itsi-server gem install itsi-scheduler (Ruby >= 3.0 only)

Mac: For Ruby >= 3.0:

  gem install itsi

(Installs both itsi-server and itsi-scheduler)

For Ruby 2.7:

  gem install itsi-server

(Installs itsi-server only; itsi-scheduler is not supported on Ruby 2.7)

ℹ️ Itsi (server + scheduler) requires Ruby >= 3.0 Itsi server supports Ruby >= 2.7 You can install components individually: gem install itsi-server gem install itsi-scheduler (Ruby >= 3.0 only)

Windows: Itsi currently doesn’t support native Windows builds, but it runs well on WSL.

Follow the linked instructions to install a Linux distribution like Ubuntu or Debian, and then follow the instructions in the Linux tab.

FreeBSD

On FreeBSD you’ll need to install a few build tools manually:

pkg install gmake cmake curl llvm

Then install Itsi with GNU make to avoid build errors:

MAKE=gmake gem install itsi

(Installs both itsi-server and itsi-scheduler)

For Ruby 2.7:

MAKE=gmake gem install itsi-server

(Installs itsi-server only; itsi-scheduler is not supported on Ruby 2.7)