Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update installation document #441

Merged
merged 1 commit into from
May 10, 2018
Merged

Update installation document #441

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
220 changes: 144 additions & 76 deletions docs/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,83 +1,151 @@
# Installation Guide

# Advanced Installation Guide
List of different installation methods:

Latest binaries build from git master are available at https://dl.bintray.com/odo/odo/latest/.
- [macOS](#macOS)
- [Deb (Debian / Ubuntu)](#deb)
- [RPM (Fedora / CentOS / RHEL)](#rpm)
- [Windows](#windows)

Builds for latest released versions are at [GitHub releases page](https://github.com/redhat-developer/odo/releases/latest).
Latest binaries are available on [Bintray](https://dl.bintray.com/odo/odo/latest/).

Latest releases are available on [Github](https://github.com/redhat-developer/odo/releases/latest).

## macOS
1. First, you need to enable `kadel/odo` Homebrew Tap:
```sh
brew tap kadel/odo
```
2.
- If you want to install latest master build
```sh
brew install kadel/odo/odo -- HEAD
```
- If you want to install latest released version
```sh
brew install kadel/odo/odo
```

## Linux
### Debian/Ubuntu and other distributions using deb
1. First, you need to add gpg [public key](https://bintray.com/user/downloadSubjectPublicKey?username=bintray) used to sign repositories.
```sh
curl -L https://bintray.com/user/downloadSubjectPublicKey?username=bintray | apt-key add -
```
2. Add odo repository to your `/etc/apt/sources.list`
- If you want to use latest master builds add `deb https://dl.bintray.com/odo/odo-deb-dev stretch main` repository.
```sh
echo "deb https://dl.bintray.com/odo/odo-deb-dev stretch main" | sudo tee -a /etc/apt/sources.list
```
- If you want to use latest released version add `deb https://dl.bintray.com/odo/odo-deb-releases stretch main` repository.
```sh
echo "deb https://dl.bintray.com/odo/odo-deb-releases stretch main" | sudo tee -a /etc/apt/sources.list
```
3. Now you can install `odo` and you would install any other package.
```sh
apt-get update
apt-get install odo
```


### Fedora/Centos/RHEL and other distribution using rpm
1. Add odo repository to your `/etc/yum.repos.d/`
- If you want to use latest master builds save following text to `/etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo`
```
# /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
[bintraybintray-odo-odo-rpm-dev]
name=bintray-odo-odo-rpm-dev
baseurl=https://dl.bintray.com/odo/odo-rpm-dev
gpgcheck=0
repo_gpgcheck=0
enabled=1
```
Or you can download it using following command:
```sh
sudo curl -L https://bintray.com/odo/odo-rpm-dev/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
```
- If you want to use latest released version save following text to `/etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo`
```
# /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
[bintraybintray-odo-odo-rpm-releases]
name=bintray-odo-odo-rpm-releases
baseurl=https://dl.bintray.com/odo/odo-rpm-releases
gpgcheck=0
repo_gpgcheck=0
enabled=1
```
Or you can download it using following command:
```sh
sudo curl -L https://bintray.com/odo/odo-rpm-releases/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
```
3. Now you can install `odo` and you would install any other package.
```sh
yum install odo
# or 'dnf install odo'
```

#### Enable via Homebrew Tap

In order to access the repo:

```sh
brew tap kadel/odo
```

#### Install

The latest MASTER build:

```sh
brew install kadel/odo/odo --HEAD
```

Latest released version:

```sh
brew install kadel/odo/odo
```

## Deb

Ubuntu / Debian

#### Add GPG Key

Add the GPG key from Bintray used to sign repositories:

```sh
curl -L https://bintray.com/user/downloadSubjectPublicKey?username=bintray | apt-key add -
```

Add the repository to `/etc/apt/sources.list`:

```sh
# For latest Master builds
echo "deb https://dl.bintray.com/odo/odo-deb-dev stretch main" | sudo tee -a /etc/apt/sources.list

# For latest signed releases
echo "deb https://dl.bintray.com/odo/odo-deb-releases stretch main" | sudo tee -a /etc/apt/sources.list
```

Now install Odo:

```sh
sudo apt-get update
sudo apt-get install odo
```

## RPM

Fedora / CentOS / RHEL

#### Add the Odo repository to `/etc/yum.repods.d/`:

For latest builds:

```sh
$ vim /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
```

```
# /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
[bintraybintray-odo-odo-rpm-dev]
name=bintray-odo-odo-rpm-dev
baseurl=https://dl.bintray.com/odo/odo-rpm-dev
gpgcheck=0
repo_gpgcheck=0
enabled=1
```

Or you can download it using following command:

```sh
sudo curl -L https://bintray.com/odo/odo-rpm-dev/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
```

For the latest release:

```sh
$ vim /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
```

```
# /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
[bintraybintray-odo-odo-rpm-releases]
name=bintray-odo-odo-rpm-releases
baseurl=https://dl.bintray.com/odo/odo-rpm-releases
gpgcheck=0
repo_gpgcheck=0
enabled=1
```

Or you can download it using following command:

```sh
sudo curl -L https://bintray.com/odo/odo-rpm-releases/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
```

#### Install Odo

```sh
# CentOS / RHEL
yum install odo

# Fedora
dnf install odo
```

## Windows
Download latest master builds from Bintray [odo.exe](https://dl.bintray.com/odo/odo/latest/windows-amd64/:odo.exe) or
builds for released versions from [GitHub releases page](https://github.com/redhat-developer/odo/releases).

1. Download the latest file from Bintray ([odo.exe](https://dl.bintray.com/odo/odo/latest/windows-amd64/odo.exe)) or from the latest release page on [GitHub](https://github.com/redhat-developer/odo/releases).
2. Extract the file
3. Add the location of extracted binary to your GOPATH/bin directory (see below if you have yet to create a Go binary directory)

#### Setting a PATH variable for Windows 7/8

Your binaries can be located wherever you like,
but we'll use `C:\go-bin` in this example.

* Create folder at `C:\go-bin`.
* Right click on "Start" and click on "Control Panel". Select "System and Security", then click on "System".
* From the menu on the left, select the "Advanced systems settings".
* Click the "Environment Variables" button at the bottom.
* Select "Path" from the "Variable" section & Click "Edit"
* Click "New"
* Type `C:\go-bin` into the field or Click "Browse" and select the directory.
* Click OK.

#### Setting a PATH variable for Windows 10

There is a faster way to edit `Environment Variables` with search
* Left click on "Search" and type `env` or `environment`. select `Edit environment variables for your account`
* and follow step above