Download and install
Scarb is a native command line application that is available for Linux, macOS and Windows on all common CPU architectures.
Scarb follows a biweekly release schedule. Each release may include new features, enhancements, bug fixes, deprecations and breaking changes. For detailed information about each release, consult the release notes.
If you are not sure if you have Scarb installed or not, you can run scarb --version
in your terminal.
Requirements
To download Git dependencies, Scarb requires a Git executable to be available in the PATH
environment variable.
Install via installation script
Installing via installation script is the fastest way to get Scarb up and running. This method only works on macOS and Linux.
Run the following in your terminal, then follow the onscreen instructions. This will install the latest stable release.
curl --proto '=https' --tlsv1.2 -sSf https://docs.swmansion.com/scarb/install.sh | sh
Run following command if you want to install the latest nightly release.
curl --proto '=https' --tlsv1.2 -sSf https://docs.swmansion.com/scarb/install.sh | sh -s -- -v nightly
If you want to install a specific version of Scarb (such as a preview or nightly version), run the following with the desired version number.
curl --proto '=https' --tlsv1.2 -sSf https://docs.swmansion.com/scarb/install.sh | sh -s -- -v 2.8.4
Uninstall
The installation script does not have uninstalling logic built-in. It tries to minimize changes performed to the system, though, to keep the number of manual steps to remove Scarb low.
- Remove the
$XDG_DATA_HOME/scarb-install
directory, usually this is~/.local/share/scarb-install
. - Remove
~/.local/bin/scarb
symbolic link.
The installation script might have added path to ~/.local/bin
to $PATH
, by adding appropriate lines to .bashrc
, .zshrc
or others, depending on the shell running in the system. If you wish, you can remove these lines, but often this is not desirable.
On top of that, Scarb creates several files (like data files or caches) in standard system paths. These have to be removed manually. The list of all global paths written to by Scarb is listed in here.
Install via asdf
asdf is a CLI tool that can manage multiple language runtime versions on a per-project basis. Scarb team maintains an official plugin for asdf which manages multiple Scarb installations. Mind that asdf works on macOS and Linux only. This plugin needs bash
, curl
, tar
and other generic POSIX utilities. Everything should be included by default on your system.
First install asdf by following the official installation guide. Make sure to complete all installation instructions from the guide, in particular add asdf to your local shell's configuration. Then run the following command to add the scarb
plugin:
asdf plugin add scarb
Show all installable versions:
asdf list-all scarb
Install latest version:
asdf install scarb latest
Install specific version:
asdf install scarb 2.8.4
Set a version globally (in your ~/.tool-versions
file):
asdf global scarb latest
Check asdf guide for more instructions on how to install & manage versions.
By operating system
Choose your operating system and tool.
Windows
As for now, Scarb on Windows needs manual installation, but necessary steps are kept to minimum:
- Download the release archive matching your CPU architecture.
- Extract it to a location where you would like to have Scarb installed. A folder named
scarb
in your%LOCALAPPDATA%\Programs
directory will suffice:batch%LOCALAPPDATA%\Programs\scarb
- Add path to the
scarb\bin
directory to yourPATH
environment variable. - Verify installation by running the following command in new terminal session, it should print Scarb and Cairo language versions:shell
scarb --version
Uninstall
Simply undo steps done to manually install Scarb:
- Remove extracted archive files.
- Remove the path to the
scarb\bin
directory fromPATH
.
On top of that, Scarb creates several files (like data files or caches) in standard system paths. These have to be removed manually. The list of all global paths written to by Scarb is listed in here.
NixOS
The community-maintained Cairo Nix overlay provides a ready-to-use Cairo development environment, which includes Scarb.
nix shell github:cairo-nix/cairo-nix
Precompiled packages
Stable version
The current stable version of Scarb is 2.8.4
.
File name | Kind | OS | Arch |
---|---|---|---|
scarb-v2.8.4-aarch64-unknown-linux-gnu.tar.gz | Archive | Linux | aarch64 |
scarb-v2.8.4-aarch64-unknown-linux-musl.tar.gz | Archive | Linux | aarch64 |
scarb-v2.8.4-x86_64-unknown-linux-gnu.tar.gz | Archive | Linux | x86_64 |
scarb-v2.8.4-x86_64-unknown-linux-musl.tar.gz | Archive | Linux | x86_64 |
scarb-v2.8.4-aarch64-apple-darwin.tar.gz | Archive | macOS | aarch64 |
scarb-v2.8.4-x86_64-apple-darwin.tar.gz | Archive | macOS | x86_64 |
scarb-v2.8.4-x86_64-pc-windows-msvc.zip | Archive | Windows | x86_64 |
scarb-v2.8.4.tar.gz | Source | ||
scarb-v2.8.4.zip | Source | ||
checksums.sha256 | Checksums |
Preview version
There is no preview version of Scarb currently.
Archived versions
For older releases, go to the releases page in Scarb GitHub repository.
Nightly builds
Scarb team publishes nightly builds of Scarb several times a week in separate GitHub repository. These builds are built on top of Scarb's and Cairo compiler's latest main
branches. Consult release notes for exact commit hashes and more information. Each build is identified by calendar day it was produced, and are tagged in the following pattern: nightly-YYYY-MM-DD
, for example: nightly-2023-08-03
.
These builds are created automatically, unattended. Use at your own risk.
Go to Scarb nightly releases on GitHub →
Platform support
Scarb is officially supported on the following platforms:
aarch64-apple-darwin
aarch64-unknown-linux-gnu
x86_64-apple-darwin
x86_64-pc-windows-msvc
x86_64-unknown-linux-gnu
The builds for following platforms builds are experimental and are not supported by Scarb team. These builds may stop being published in the future. Use at your own risk:
aarch64-unknown-linux-musl
x86_64-unknown-linux-musl
Source code
Scarb is an open source project developed by Software Mansion, available under terms of the MIT License. We host our Git repository on GitHub. We also welcome external contributors!