The Archil CSI Driver is currently in preview.
The Archil CSI Driver provides seamless integration between Kubernetes and Archil’s distributed disk technology. It implements the CSI specification to allow Kubernetes workloads to mount and use Archil volumes with both ReadWriteOnce (RWO) and ReadWriteMany (RWX) access modes.

​
Quick Start

Get started with the Archil CSI Driver in just a few steps:

​
1. Install CSI Driver

# Add Archil Helm repository
helm repo add archil https://charts.archil.com
helm repo update

# Install the CSI driver
helm install archil-csi archil/archil-csi-driver \
  --set archilEnv=test.aws.us-east-1.cyan \
  --set serviceAccount.annotations."eks\.amazonaws\.com/role-arn"=arn:aws:iam::ACCOUNT:role/archil-csi-driver-role

​
2. Create PersistentVolume

---
apiVersion: v1
kind: PersistentVolume
metadata:
  name: archil-pv-token
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  csi:
    driver: csi.archil.com
    volumeHandle: unique-volume-id-001
    volumeAttributes:
      diskId: dsk-0000000000001c85
      region: aws-us-east-1
    nodePublishSecretRef:
      name: archil-token-dsk-0000000000001c85
      namespace: demo

​
3. Create PVC and Use in Pod

---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-archil-disk
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: archil-storage
  resources:
    requests:
      storage: 1Gi  # Size is unused - actual capacity is infinite
  volumeName: my-archil-disk
---
apiVersion: v1
kind: Pod
metadata:
  name: my-app
spec:
  containers:
  - name: app
    image: nginx
    volumeMounts:
    - name: data
      mountPath: /data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: my-archil-disk

​
Configuration reference

​
Storage access modes

The accessMode that you use when creating your PersistentVolume and PersistentVolumeClaim will determine whether the disk is mounted with support for other clients to access it. When using ReadWriteOnce, the disk is mounted into single ownership mode, preventing other clients from accessing the disk. When using ReadWriteMany, the disk is mounted with --shared, allowing multiple clients to access the disk simultaneously. For more details, see the Shared Disks page.

​
Helm Chart values

The following table describes all available configuration options in values.yaml:
ParameterDescriptionDefaultRequired
image.repositoryContainer image repositoryarchildata/csi-driver-devYes
image.tagContainer image tagv0.1.0Yes
image.pullPolicyImage pull policyAlwaysNo
archilEnvArchil environment identifiertest.aws.us-east-1.cyanYes
logLevelLogging verbosity leveldebugNo
serviceAccount.createCreate service accounttrueNo
serviceAccount.annotationsService account annotations for AWS STS{}No
dockerHub.createSecretCreate Docker Hub secretfalseNo
dockerHub.usernameDocker Hub username""No
dockerHub.passwordDocker Hub password""No
dockerHub.emailDocker Hub email""No
extraEnvExtra environment variables[]No
imagePullSecretsImage pull secrets[{name: dockerhub-secret}]No
resourcesResource limits and requests{}No
nodeSelectorNode selector constraints{}No
tolerationsPod tolerations[]No
affinityPod affinity rules{}No

​
Changelog

​
2025-07-23
  • Initial preview release