Installing Kubeflow

Overview of installation choices for various environments

Before you begin

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

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 theseKubernetes system requirements.

Installing Kubeflow

There are various ways to install Kubeflow. Choose one of the following optionsto suit your environment (desktop or server, existing Kubernetes cluster, or public cloud):

Configuration quick reference

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

Deployment platform Manifest Deployment guide
Existing Kubernetes cluster using a standard Kubeflow installation kfctl_k8s_istio.0.7.1.yaml Docs
Existing Kubernetes cluster using Dex for authentication kfctl_existing_arrikto.0.7.1.yaml Docs
Amazon Web Services (AWS) using the standard setup kfctl_aws.0.7.1.yaml Docs
Amazon Web Services (AWS) with authentication kfctl_aws_cognito.0.7.1.yaml Docs
Microsoft Azure kfctl_k8s_istio.0.7.1.yaml Docs
Google Cloud Platform (GCP) with basic authentication kfctl_gcp_basic_auth.0.7.1.yaml Docs
Google Cloud Platform (GCP) with Cloud Identity-Aware Proxy (Cloud IAP) kfctl_gcp_iap.0.7.1.yaml Docs
IBM Cloud Private kfctl_k8s_istio.0.7.1.yaml Docs

Installing command line tools

The following information is useful if you need or prefer to use command linetools for deploying and managing Kubeflow:

  • Download the kfctl binary from theKubeflow releases page.

  • Follow the kubectl installation and setup instructions from the Kubernetesdocumentation.As described in the Kubernetes documentation, your kubectlversion must be within one minor version of the Kubernetes version that youuse in your Kubeflow cluster.

  • Follow the kustomize installation and setup instructions from the guide tokustomize in Kubeflow.

Troubleshooting

See the Kubeflow troubleshooting guide.

Next steps