Skip to main content
Version: 1.0.0

On-Premise Cluster

Katonic's workspace Volumes feature enables you to use workspaces with a persistent volume and reopen closed workspaces exactly as they were shut down.

While the feature is supported natively with cloud clusters, some configuration work is required to enable it to work with on-premise clusters. This guide will explain how to set it up.


  • kubectl and access to the Kubernetes cluster
  • A NFS server running as part of the cluster so that the nodes can access it

Update the exports on the NFS server#

Open /etc/exports in the NFS server and add the following line:

/your/nfs/share/dir *(rw,sync,no_subtree_check,no_root_squash)

Install Required Packages on each Node#

Each node in the Kubernetes cluster needs to have the NFS client library installed. You can install it with the following command:


sudo apt-get install nfs-common


sudo yum install nfs-utils

Deploy the NFS Provisioner#

The NFS provisioner is responsible for dynamically provisioning the NFS storage for volumes.

It consists of three parts:

  • RBAC - responsible for controlling the access
  • Deployment - the actual provisioner
  • StorageClass - describing the type of storage

Once we have created all three, the configuration will be complete.

Create the RBAC#

Here is the required RBAC YAML file. Save the YAML to your computer as rbac.yaml:

apiVersion: v1
kind: ServiceAccount
name: nfs-client-provisioner
namespace: "Katonic"


Congratulations, you have now set up a working ON-PREM cluster!

Follow this guide to complete the setup.