Skip to main content
Version: 1.4.0

Download SAFE CLI

OSDownload Link
 MacOS (Silicon and Intel)SAFE 1.4.0 (x86_64)
🐧 LinuxSAFE 1.4.0 Linux (x86_64)

By downloading and using SAFE, you agree to the SAFE End User License Agreement.

info

For Mac Users: The macOS release is built for Intel processors.

  • Intel-based Macs: No action required — everything will work out of the box.
  • Apple Silicon Macs: You'll need Rosetta 2 installed (most systems already have it).

Requirements​

SAFE packages its own dependencies, but we need to have the following installed on your system (these are commonly available on most systems):

  • OpenSSL 3
  • Glibc 2.31 or higher for Linux systems

Installation​

Click the appropriate download link in the table above to save the .tar.gz archive to your machine. Then follow the steps for your operating system.

Linux​

# Move to the directory where you saved the downloaded archive, e.g.:
cd ~/Downloads

# Create the install directory
mkdir -p ~/.safe/install

# Extract the archive (the filename matches the link you clicked above)
tar -xzf safe-1.4.0-linux-x86_64.tar.gz -C ~/.safe/install

# Add SAFE to your PATH permanently so it is available in every terminal session
echo 'export PATH="$HOME/.safe/install:$PATH"' >> ~/.bashrc
source ~/.bashrc

Then verify the installation:

safe version

macOS​

macOS uses Zsh as the default shell since macOS Catalina (10.15). If you are still using Bash, see the note below.

# Move to the directory where you saved the downloaded archive, e.g.:
cd ~/Downloads

# Create the install directory
mkdir -p ~/.safe/install

# Extract the archive (the filename matches the link you clicked above)
tar -xzf safe-1.4.0-macos-x86_64.tar.gz -C ~/.safe/install

# Add SAFE to your PATH permanently (Zsh — default on macOS Catalina and later)
echo 'export PATH="$HOME/.safe/install:$PATH"' >> ~/.zshrc
source ~/.zshrc

Then verify the installation:

safe version
info

Using Bash on macOS? Replace ~/.zshrc with ~/.bash_profile:

echo 'export PATH="$HOME/.safe/install:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

CI/CD (download on the fly, no shell restart needed)​

In CI/CD environments you typically download SAFE on the fly and add it to the PATH for the duration of the job — no need to permanently modify any shell profile. Copy the Linux download URL from the table at the top of this page and use it in the commands below.

mkdir -p ~/.safe/install

# Replace the URL with the Linux download link from the table above
curl -fsSL -o ~/.safe/safe.tar.gz https://safe-releases.s3.eu-central-1.amazonaws.com/1.4.0/safe-1.4.0-linux-x86_64.tar.gz

tar -xzf ~/.safe/safe.tar.gz -C ~/.safe/install
export PATH=$HOME/.safe/install:$PATH

# Run the analysis
safe analyse --config-path .safe/config.json
tip

The download URL will change with each SAFE release. Always copy the latest URL from the download table at the top of this page.

Incremental analysis with caching​

SAFE stores its analysis state in ~/.safe. When you cache this directory between pipeline runs, SAFE can skip files that have not changed and only re-analyse what is new or modified — making repeat runs significantly faster.

Configure your CI/CD system to save and restore ~/.safe around the SAFE step.

Contents