Install the SnapLogic CLI

Install the snaplogic CLI as a standalone tool on macOS, Windows, or Linux.

Important: If you use SnapCode, it downloads the SnapLogic CLI for you. You don't need to install it separately. Refer to Install SnapCode.

Supported platforms

Platform Architecture Install method
macOS Apple Silicon (arm64), Intel (amd64) Install script
Linux amd64, arm64 Install script
Windows amd64, arm64 PowerShell install script
Windows Subsystem for Linux (WSL) amd64, arm64 Install script (same as Linux)

The CLI is a self-contained binary. No runtime (Python, Node, or Java) is required.

macOS and Linux — install script

Run the command for your control plane environment:

US (elastic.snaplogic.com):

curl -fsSL "https://elastic.snaplogic.com/api/1/rest/slserver/cli/installer/install.sh?binary=true" | sh

US-2 (elastic2.snaplogic.com):

curl -fsSL "https://elastic2.snaplogic.com/api/1/rest/slserver/cli/installer/install.sh?binary=true" | sh

EMEA (emea.snaplogic.com):

curl -fsSL "https://emea.snaplogic.com/api/1/rest/slserver/cli/installer/install.sh?binary=true" | sh

The script downloads the correct binary for your OS and architecture, verifies the checksum, and installs it. On Linux, it installs to /usr/local/bin if writable, or falls back to $HOME/.local/bin for non-root users.

Windows — PowerShell install script

Run the command for your control plane environment:

US (elastic.snaplogic.com):

irm "https://elastic.snaplogic.com/api/1/rest/slserver/cli/installer/install.ps1?binary=true" | iex

US-2 (elastic2.snaplogic.com):

irm "https://elastic2.snaplogic.com/api/1/rest/slserver/cli/installer/install.ps1?binary=true" | iex

EMEA (emea.snaplogic.com):

irm "https://emea.snaplogic.com/api/1/rest/slserver/cli/installer/install.ps1?binary=true" | iex
Important: Run this command in a standard PowerShell window, not Windows PowerShell ISE or a restricted execution policy environment. If your execution policy blocks the script, run Set-ExecutionPolicy RemoteSigned -Scope Process first. This limits the policy change to the current PowerShell window only.

Verify the installation

After installing, open a new terminal and run:

snaplogic --version

The command prints the installed version number. If you see command not found, the install directory is not on your PATH. Add it manually and open a new terminal:

  • macOS / Linux (non-root install): add export PATH="$HOME/.local/bin:$PATH" to your shell profile and run source ~/.zshrc (or open a new terminal).
  • Windows: the install script adds the binary to your PATH automatically. If the command is still not found, open a new terminal.

Updates

At most once a day, when a command runs, the CLI checks the control plane it was installed from for a newer version. If one is available, it prints New SnapLogic CLI version available! and downloads the update in the background without interrupting your command. The update takes effect the next time you run snaplogic. There is no update command or setting for the update check.

To check the currently installed version at any time:

snaplogic --version

To update manually, run the install command for your control plane environment again:

Uninstall

macOS / Linux:

Remove the binary from the directory where it was installed:

rm $HOME/.local/bin/snaplogic          # non-root install
sudo rm /usr/local/bin/snaplogic      # root install

Windows:

Run the following in PowerShell to remove the binary and clean up the PATH entry:

Remove-Item -Path "$env:LOCALAPPDATA\snaplogic\bin" -Recurse -Force

$InstallDir = (Join-Path $env:LOCALAPPDATA "snaplogic\bin").TrimEnd('\')
$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
$NewUserPath = ($UserPath -split ";" | Where-Object { $_.TrimEnd('\') -ine $InstallDir }) -join ";"
[Environment]::SetEnvironmentVariable("Path", $NewUserPath, "User")
$env:Path = $NewUserPath