Skip to main content
Version: v3

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.

CLI Installation​

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.16.1/odo-linux-amd64 -o odo
  1. (Recommended) 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.16.1/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 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.16.1/odo-darwin-amd64 -o odo
  1. (Recommended) 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.16.1/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.16.1/odo-windows-amd64.exe -o odo.exe
  1. (Recommended) 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.16.1/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

IDE Installation​

Visual Studio Code (VSCode)​

The OpenShift Toolkit VSCode extension uses both odo and oc binaries to interact with Kubernetes or OpenShift cluster.

To install it:

  1. Open VS Code.
  2. Launch VS Code Quick Open (Ctrl+P).
  3. Paste the following command and press Enter:
ext install redhat.vscode-openshift-connector

JetBrains IDEs​

The OpenShift Toolkit by Red Hat plugin can be installed to interact with OpenShift or Kubernetes clusters right from your JetBrains IDEs like IntelliJ IDEA, WebStorm or PyCharm. It uses odo and oc binaries for fast iterative application development on those clusters.

To install it:

  1. Press Ctrl+Alt+S to open the IDE settings and select Plugins.
  2. Find the "OpenShift Toolkit by Red Hat" plugin in the Marketplace and click Install.

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 the 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.16.1

asdf​

The asdf version manager is a tool for managing multiple runtime versions using a common CLI. With asdf installed, the asdf plugin for odo can be used to install any released version of odo:

asdf plugin add odo
asdf install odo 3.16.1
asdf global odo 3.16.1

Nightly builds​

Nightly builds of odo are also available. Note that these builds are provided as is and can be highly unstable.

Linux​

Installing odo on amd64 architecture:

  1. Download the latest nightly build:
curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-linux-amd64 -o odo

To download a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-linux-amd64-${gitCommitId} -o odo
  1. (Recommended) Verify the downloaded binary with the SHA-256 sum:
curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-linux-amd64.sha256 -o odo.sha256
echo "$(<odo.sha256)  odo" | shasum -a 256 --check

To verify a download for a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-linux-amd64-${gitCommitId}.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​

Installing odo on amd64 architecture:

  1. Download the latest nightly build:
curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-darwin-amd64 -o odo

To download a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-darwin-amd64-${gitCommitId} -o odo
  1. (Recommended) Verify the downloaded binary with the SHA-256 sum:
curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-darwin-amd64.sha256 -o odo.sha256
echo "$(<odo.sha256)  odo" | shasum -a 256 --check

To verify a download for a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-darwin-amd64-${gitCommitId}.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 nightly build:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-windows-amd64.exe -o odo.exe

To download a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-windows-amd64-${gitCommitId}.exe -o odo.exe
  1. (Recommended) Verify the downloaded binary with the SHA-256 sum:
curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-windows-amd64.exe.sha256 -o odo.exe.sha256
# Visually compare the output of both files
Get-FileHash odo.exe
type odo.exe.sha256

To verify a download for a specific commit instead, run:

curl -L https://s3.eu-de.cloud-object-storage.appdomain.cloud/odo-nightly-builds/odo-windows-amd64-${gitCommitId}.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