Quickstart

Tags:

  2 minute read  

How to install KOSI

This quickstart shows you how to install KOSI. KOSI can be downloaded only from our official website.

Install KOSI as user

Prerequisites

Before you begin, check the following prerequisites:

  1. A machine with any of the following operating systems
  • RHEL 8
  • openSUSE or SUSE Linux Enterprise Server Version 15 SP3
  1. You must have Helm installed on your machine.

Refer Helm Official Documentation for Installation Guide.

  1. For KOSI versions you must have installed Podman on your machine.

Note : Before installing podman, make sure that The number of user namespaces (max_user_namespaces) is specified on your system if you are a non root-user.
For more information, follow this Github link

To install podman on your OS use command:

dnf install podman
zypper install podman

Important: Only supports secure registries. If you use an insecure registry, it is important to list your registry as an insecure registry in registry.conf (/etc/containers/registries.conf).

Installation Steps

Every release of KOSI provides a rpm file for manual installation. You need to login into your KubeOps account to download the file.

  1. Create an KubOps account on the KubeOps website if you don’t have already and login into your account.

  2. Download your desired version of KOSI .rpm file from our official download page https://kubeops.net/products/downloads/kosi-downloads-en

  3. Install the KOSI rpm on master node or admin node (recommended). 

    dnf install <path to rpm>/<kosi file name>
    zypper install <path to rpm>/<kosi file name>

path to rpm : the directory path in which the file is available.
kosi file name : the exact file name of the file with .rpm extension.

Check Installation

You can check if the kosi is installed correctly on your machine simply with command kosi version.

kosi version

If the output indicates kosi version and relative information, KOSI is installed successfully.

For example the output should look like

KOSI version: 2.9.0_Alpha0_1701852856
This work is licensed under Creative Commons Attribution - NoDerivatives 4.0 International License(see https://creativecommons.org/licenses/by-nd/4.0/legalcode for more details).
©KubeOps GmbH, Hinter Stöck 17, 72406 Bisingen - Germany, 2022

Create a KOSI package

If you have installed KOSI on your machine, you can not only download and install packages, you can also create your own packages.

Create a KOSI package

Upgrade to newer KOSI version

If you have already installed KOSI on your machine and want to upgrade to a newer version, please install the new version with same steps mentioned above.

Once you have successfully installed KOSI, you are ready to use KOSI.
Update KOSI