Deploy Polyaxon

If you are here, it means that you have a Kubernetes cluster and helm setup, if not please read how you can install kubernetes, and setup helm.

Please consider using this small interactive app to help you navigate the most important options to install Polyaxon.

Please also check the helm reference for all default values.

Create a namespace for Polyaxon

Polyaxon is installed and relies on the namespace to run experiments independently of other applications running on your cluster, we recommend using polyaxon.

$ kubectl create namespace polyaxon

namespace "polyaxon" created

If you would like to use a different name, you must keep im mind to update the namespace value in your config.


This section will guide you through how you can create a configuration file to deploy Polyaxon. Polyaxon ships with default values, however and depending on your use case you might need to override some of these values. To do so, you need to create a configuration file and we recommend to save it somewhere safe so that you can reuse it in the future.

Create a config file config.yml or polyaxon_config.yml, and set up all information you want to override in the default config.

Example, disabling ingress and RBAC

  enabled: false

  enabled: false

serviceType: LoadBalancer

Example, adding database persistence

    enabled: true
    size: 5Gi

Example, updating the default user:

  username: "root"
  email: "[email protected]"
  password: "dummypassword"

Install Polyaxon

First of all, you need to add the Polyaxon helm repository to your helm, so you can install Polyaxon from it. This makes it easy to refer to the Polyaxon chart without having to use a long URL each time.

$ helm repo add polyaxon
$ helm repo update

Now you can install Polyaxon with your config.yml file

$ helm install polyaxon/polyaxon \
    --name=<RELEASE_NAME> \
    --namespace=<NAMESPACE> \
    -f config.yml

--name is an identifier used by helm to refer to this deployment. You need it when you are changing the configuration of this install or deleting it. We recommend using RELEASE_NAME = polyaxon or RELEASE_NAME = plx.

--namespace should be the same value of the namespace you created in the first step, we again recommend using polyaxon to make it always easy to remember.


We recommend using polyaxon for both the --name and --namespace to avoid too much confusion. The same command with polyaxon as a value:

$ helm install polyaxon/polyaxon \
--name=polyaxon \
--namespace=polyaxon \
-f config.yml
Release name already exists error

If you get a release named <RELEASE_NAME> already exists error, then you should delete the release by running helm delete --purge <RELEASE_NAME>.

You can see the pods being created by entering in a different terminal:

$ kubectl --namespace=<NAMESPACE> get pod

When helm is done deploying Polyaxon, it will output some instructions NOTES, that depends on the service type used and / or ingress;

Polyaxon is currently running:

1. Get the application URL by running these commands:

     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
           You can watch the status by running:
           'kubectl get --namespace polyaxon svc -w polyaxon-polyaxon-api'

  export POLYAXON_IP=$(kubectl get svc --namespace polyaxon polyaxon-polyaxon-ingress -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

  export POLYAXON_WS_PORT=80


2. Setup your cli by running theses commands:

  polyaxon config set --host=$POLYAXON_IP --http_port=$POLYAXON_HTTP_PORT  --ws_port=$POLYAXON_WS_PORT

3. Log in with superuser

  USER: root
  PASSWORD: Get login password with

    kubectl get secret --namespace polyaxon polyaxon-polyaxon-secret -o jsonpath="{.data.POLYAXON_ADMIN_PASSWORD}" | base64 --decode

These notes are important for setting the CLI, and getting access to the dashboard.

Next step we will install the CLI and configure the host and the ports based on the these notes.

You can also check how you can extend this deployment in many ways.

Install Polyaxon On Minikube

For Minikube, we recommend Virtualbox/VMware drivers, but you can also use other drivers.

We recommend also to increase the amount of resources allocates:

minikube start --cpus 4 --memory 8192 --disk-size=40g

By default Minikube allocates 2Gb of RAM, this not enough for Polyaxon and we recommend at least 6Gb.

By default Polyaxon uses ingress (with serviceType ClusterIP) and RBAC, you might need to disable one / both of them in your config.yml/polyaxon_config.yml:

isMinikube: true

  enabled: false

  enabled: false

serviceType: LoadBalancer

It is however recommended to enable RBAC and start minikube with the option --extra-config=apiserver.authorization-mode=RBAC.

After installing polyaxon, you might need to use the following command to enable access to the API service:

minikube service -n polyaxon polyaxon-polyaxon-api

Note that when using minikube, the IP address of the application is given by minikube ip.

Upgrade Polyaxon

To upgrade Polyaxon to a newer version, you can simply run:

helm update
helm upgrade polyaxon polyaxon/polyaxon -f polyaxon-config.yml