Getting Started

Prerequisites

Most Linux installs on common x86_64 and ARM64 targets can use the precompiled native gems directly. If RubyGems falls back to the source gems, you’ll need a C/C++ build environment plus clang and curl (for running rustup).

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: Most macOS installs on Apple Silicon and Intel Macs can use the precompiled native gems directly. If RubyGems falls back to the source gems, install Xcode Command Line Tools first.

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

FreeBSD currently relies on source builds, so 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)