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

Installation

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

CLI installation​

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~alpha2/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~alpha2/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​

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~alpha2/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~alpha2/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~alpha2/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~alpha2/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

Installing from 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

Installing odo using 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~alpha2

IDE Installation​

Installing odo in Visual Studio Code (VSCode)​

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

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