Skip to main content
Version: 3.0.0 (RC 2) 🚧

Installation

odo can be used as either a CLI tool or an IDE plugin on Mac, Windows or Linux.

Each release is signed, checksummed, verified, and then pushed to our binary mirror.

For more information on the changes of each release, they can be viewed either on GitHub or the blog.

Linux

Installing odo on amd64 architecture:

  1. Download the latest release from the mirror:
curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-linux-amd64 -o odo
  1. (Optional) Verify the downloaded binary with the SHA-256 sum:
curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-linux-amd64.sha256 -o odo.sha256
echo "$(<odo.sha256) odo" | shasum -a 256 --check
  1. Install odo:
sudo install -o root -g root -m 0755 odo /usr/local/bin/odo
  1. (Optional) If you do not have root access, you can install odo to the local directory and add it to your $PATH:
mkdir -p $HOME/bin 
cp ./odo $HOME/bin/odo
export PATH=$PATH:$HOME/bin
# (Optional) Add the $HOME/bin to your shell initialization file
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

MacOS

Homebrew

NOTE: This will install from the main branch on GitHub

Installing odo using Homebrew:

  1. Install odo:
brew install --HEAD odo-dev
  1. Verify the version you installed is up-to-date:
odo version

Binary

Installing odo on amd64 architecture:

  1. Download the latest release from the mirror:
curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-darwin-amd64 -o odo
  1. (Optional) Verify the downloaded binary with the SHA-256 sum:
curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-darwin-amd64.sha256 -o odo.sha256
echo "$(<odo.sha256) odo" | shasum -a 256 --check
  1. Install odo:
chmod +x ./odo
sudo mv ./odo /usr/local/bin/odo
  1. (Optional) If you do not have root access, you can install odo to the local directory and add it to your $PATH:
mkdir -p $HOME/bin 
cp ./odo $HOME/bin/odo
export PATH=$PATH:$HOME/bin
# (Optional) Add the $HOME/bin to your shell initialization file
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

Windows

  1. Open a PowerShell terminal

  2. Download the latest release from the mirror:

curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-windows-amd64.exe -o odo.exe
  1. (Optional) Verify the downloaded binary with the SHA-256 sum:
curl -L https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo/v3.0.0~rc2/odo-windows-amd64.exe.sha256 -o odo.exe.sha256
# Visually compare the output of both files
Get-FileHash odo.exe
type odo.exe.sha256
  1. Add the binary to your PATH

Alternative installation methods

Source code

  1. Clone the repository and cd into it.
    git clone https://github.com/redhat-developer/odo.git
    cd odo
  2. Install tools used by the build and test system.
    make goget-tools
  3. Build the executable from the sources in cmd/odo.
    make bin
  4. Check the build version to verify that it was built properly.
    ./odo version
  5. Install the executable in the system's GOPATH.
    make install
  6. Check the binary version to verify that it was installed properly; verify that it is same as the build version.
    odo version

Maven plugin

It is possible to integrate the odo binary download in a Maven project using odo Downloader Plugin. The download can be executed using download goal which automatically retrieves the version for the current architecture:

mvn software.tnb:odo-downloader-maven-plugin:0.1.3:download \
-Dodo.target.file=$HOME/bin/odo \
-Dodo.version=v3.0.0~rc2