Jenkins X v2 is not in active development. Refer to the v3 documentation for the latest supported version.

Download the jx binary

How to download and install the jx binary on your machine

Pick the most suitable instructions for your operating system:

macOS

Download the jx binary

On a Mac you can use brew:

brew install jenkins-x/jx/jx

Alternatively, download the jx binary archive using curl and pipe (|) the compressed archive to the tar command:

curl -L "https://github.com/jenkins-x/jx/releases/download/$(curl --silent "https://github.com/jenkins-x/jx/releases/latest" | sed 's#.*tag/\(.*\)\".*#\1#')/jx-darwin-amd64.tar.gz" | tar xzv "jx"

Install the jx binary by moving it to a location in your executable path using using the mv command:
```
sudo mv jx /usr/local/bin
```
Run jx version --short to make sure you’re on the latest stable version
```
jx version --short
```

Linux

To install Jenkins X on Linux, download the .tar file, and unarchive it in a directory where you can run the jx command.

Download the jx binary archive using curl and pipe (|) the compressed archive to the tar command:

curl -L "https://github.com/jenkins-x/jx/releases/download/$(curl --silent "https://github.com/jenkins-x/jx/releases/latest" | sed 's#.*tag/\(.*\)\".*#\1#')/jx-linux-amd64.tar.gz" | tar xzv "jx"

Install the jx binary by moving it to a location in your executable path using using the mv command:
```
sudo mv jx /usr/local/bin
```
Run jx version --short to make sure you’re on the latest stable version
```
jx version --short
```

Windows

You can install Jenkins X on Windows through Chocolatey, a third-party package management system that provides convenient one-step commands for local Jenkins X installations and upgrades.

Install the Chocolatey package management system using an Administrative Shell:

Right-click menu:Start[Command Prompt (Admin)].

At the shell prompt, execute a powershell.exe command to download and install the choco binary and set the installation path so that the binary can be executed:

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

Install Jenkins X using Chocolatey:
```
choco install jenkins-x
```
You can update to the latest version of Jenkins X using Chocolatey:
```
choco upgrade jenkins-x
```
If you use scoop, then there is a manifest available.

To install the jx binary run:
```
scoop install jx
```
To upgrade the jx binary run:
```
scoop update jx
```

Other platforms

Download the binary for jx and add it to your $PATH

Or you can try build it yourself. Though if build it yourself please be careful to remove any older jx binary so your local build is found first on the $PATH :)

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified July 25, 2020: fix: change broken external link to an internal link (042f4459fb)