chpharos is a tool for installing and using multiple versions of pharos and the compatible tools such as kubectl for each.


  • A shell compatible with bash version 3 or newer
  • A tool for downloading files (currently supported: curl and wget, usually already installed on compatible systems)


From the command-line

To install from the command-line, use:

curl -s | bash

To view the installer command-line options, use:

curl -s | bash -s -- -h

Via MacOS homebrew

To install using the Homebrew package manager, use:

brew install kontena/chpharos/chpharos

Then follow the instructions in the post install message to add it to your shell startup scripts.

From source packages

  1. Download a source package from releases page
  2. Extract the archive and go into the extracted directory
  3. make install


  1. Download the
  2. Add a line to your shell's start-up configuration file (.bash_profile, .zshrc, ..) to load it: source <>
mkdir -p ~/.pharos/chpharos && \
  curl -sL > ~/.pharos/ && \
  echo "source ~/.pharos/" >> ~/.bash_profile

Usage and features

List available versions

chpharos list-remote

Use chpharos list-remote --pre to include pre-release/beta versions.

Install a version

chpharos install 1.1.1

To install the latest version, use chpharos install latest

You can give --use option to automatically select the installed version as current version of pharos tool.

List installed versions

chpharos list

Select a version to use

chpharos use 1.1.1

Display the currently used version

chpharos current

Uninstall a version

chpharos uninstall 1.1.1

Automatic version switching

chpharos can be used in an automatic mode where switching to a directory or a git-repository that contains a .pharos-version file will automatically switch to the version specified in the file.

To enable this, you need to add a line in your start-up scripts after the loading of

chpharos auto
echo "chpharos auto" >> ~/.bash_profile

You can use chpharos use --local 1.1.1 to create a .pharos-version file in the current directory or chpharos use --default 1.1.1 to set a default version by creating a .pharos-version file in the $HOME directory.

Tab completions

  1. Download the
  2. Place the file into the completion configuration directory (on your machine or add a line to your shell's start-up configuration file (.bash_profile, .zshrc, ..) to load it: source <>

results matching ""

    No results matching ""