Installing the chectl management tool

You can install chectl, the Eclipse Che command-line management tool, on Microsoft Windows, Apple MacOS, and Linux. With chectl, you can perform operations the Che server such as starting, stopping, updating, and deleting the server.

Installing the chectl management tool on Windows

This section describes how to install the chectl management tool on Windows.

Procedure

  • Run the following command in the PowerShell terminal:

    C:\Users> Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://www.eclipse.org/che/chectl/win/'))
Verification steps

  • The chectl tool is available at C:\ProgramData\chectl.

Installing the chectl management tool on Linux or macOS

This section describes how to install the chectl management tool on Linux or macOS.

Prerequisites

  • The directory /usr/local/bin is in the user $PATH.

  • The sudo command is configured for the current user.

  • No old or undesired versions of chectl present on the system.

Procedure

  1. Run the following command in the terminal (this downloads and executes the install.sh script):

    $ bash <(curl -sL  https://www.eclipse.org/che/chectl/)

  2. Run the following command to verify that the chectl tool is available at /usr/local/bin/chectl:

    $ which chectl
/usr/local/bin/chectl

  3. Run the following command to verify that the version of chectl that is the expected one.

    $ chectl --version

    To identify the latest stable release, see the list of chectl releases and search for a release not containing "next" in the name.

  4. Read the installation logs.

    $ cat chectl-install.log
Additional resources