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

  1. 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"
    
  2. 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
    
  3. 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.

  1. 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"
    
  2. 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
    
  3. 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:

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

  2. 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"
    
  3. 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
    
  4. 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 :)