Installing Kubeflow

Overview of installation choices for various environments

This document provides information about setting up Kubeflow in various environments.

Before you begin

It’s important that you have some knowledge of the following systems and tools:

If you plan to deploy Kubeflow on an existing Kubernetes cluster, review these Kubernetes system requirements.

Overview of installation options

The following diagram gives an overview of the options for deploying Kubeflow:

The following section describes the options in more detail and links to the relevant instructions.

Installing Kubeflow

There are various ways to install Kubeflow. Choose one of the following options to suit your environment (public cloud, existing Kubernetes cluster, or a single-node cluster which you can use on a desktop or server or in the cloud).

Installing Kubeflow on a public cloud

Choose the Kubeflow deployment guide for your chosen cloud:

Installing Kubeflow on an existing Kubernetes cluster

Follow the guide to deploying Kubeflow on Kubernetes.

Installing Kubeflow on desktop, server, or cloud in a single-node Kubernetes cluster

You can use the following options to run Kubeflow on a single-node Kubernetes cluster, which you can use on a desktop or server or in the cloud.

Choose the guide for your operating system or environment:

Deployment quick reference

Below is a matrix of the platforms where you can deploy Kubeflow and the corresponding manifest files that specify the default configuration for each platform. The matrix shows the same manifests as the installation guides. The matrix is therefore an alternative way of accessing the information in the installation section above.

Deployment platformDeployment guide
Existing Kubernetes cluster using a standard Kubeflow installationDocs
Existing Kubernetes cluster using Dex for authenticationDocs
Amazon Web Services (AWS) using the standard setupDocs
Amazon Web Services (AWS) with authenticationDocs
Microsoft AzureDocs
Google Cloud Platform (GCP) with Cloud Identity-Aware Proxy (Cloud IAP)Docs
IBM Cloud (IKS)Docs
OpenShiftDocs

Understanding the Kubeflow versioning policies

With the launch of Kubeflow v1.2.0, the Kubeflow community attributes stable status to those applications and other components that meet the required level of stability, supportability, and upgradability.

Read about the Kubeflow versioning policies, including the stable status of Kubeflow applications and deployment platforms.

Troubleshooting

See the Kubeflow troubleshooting guide.

Next steps

Last modified 20.04.2021: Apply Docs Restructure to `v1.2-branch` = update `v1.2-branch` to current `master` v2 (#2612) (4e2602bd)