Install jx

How to 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 tap jenkins-x/jx
    brew install jx
    

    Alternatively, to install Jenkins X on macOS without brew, 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://api.github.com/repos/jenkins-x/jx/releases/latest | jq -r '.tag_name')/jx-darwin-amd64.tar.gz" | tar xzv "jx"
    

    or, if you don’t have jq installed:

    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 to make sure you’re on the latest stable version

    jx --version
    

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://api.github.com/repos/jenkins-x/jx/releases/latest | jq -r '.tag_name')/jx-linux-amd64.tar.gz" | tar xzv "jx"
    

    or, if you don’t have jq installed:

    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 to make sure you’re on the latest stable version

    jx --version
    

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

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 :)

Getting Help

To find out the available commands type:

jx

Or to get help on a specific command, say, create then type:

jx help create

You can also browse the jx command reference documentation



Last modified December 14, 2019: release 0.0.1346 (dcfae35)