Download - Mapfs Developer Edition

Linux Packages

Download installation packages for Linux systems

Package Manager:

RPM DEB

Architecture:

x86-64 ARM64

Download

System Requirements: GLIBC >=2.34, e.g:

Red Hat Enterprise Linux (RHEL): 9.x
AlmaLinux/Rocky Linux/CentOS Stream: 9.x
Oracle Linux: 9.x
AmazonLinux 2023
Ubuntu 22.04 LTS
SUSE Linux Enterprise 15 SP6
openSUSE Leap 15.6

Docker Image

Pull the Docker image from the registry

Architecture: x86-64 (amd64), ARM64 (aarch64)

docker pull wyflow/mapfs:2.4.2

Kubernetes CSI Driver

Install the CSI driver via Helm, then configure a storage backend with Kubernetes manifests

Step 1: Download manifests & install the driver (Helm)

Pick the bundle matching your cluster — each is a separate, self-contained download.

Generic Kubernetes

Any cluster, static access key/secret key, any supported vendor (S3/AWS, GCS, Azure, Wasabi, Aliyun, Cloudflare, Oracle, S3-compatible).

Download Manifests

tar xzf mapfs-csi-manifests-kubernetes-1.1.3.tar.gz && cd mapfs-csi-manifests-kubernetes-1.1.3
kubectl apply -f channel-server.yaml

helm install mapfs-csi oci://registry-1.docker.io/wyflow/mapfs-csi-chart --version 1.1.3 \
  --set license.email=you@example.com \
  --set license.token=<token-from-mapfs-portal> \
  --set channelServer.address=mapfs-channel.kube-system.svc.cluster.local:7777

See the Kubernetes quick start for full steps.

AWS EKS (IRSA)

EKS only. Uses IRSA, no static AWS credentials — required for AWS Marketplace listings.

Download Manifests

tar xzf mapfs-csi-manifests-eks-1.1.3.tar.gz && cd mapfs-csi-manifests-eks-1.1.3
kubectl apply -f channel-server.yaml

helm install mapfs-csi oci://709825985650.dkr.ecr.us-east-1.amazonaws.com/wyflow/mapfs-csi-chart --version 1.1.3 \
  --set license.email=you@example.com \
  --set license.token=<token-from-mapfs-portal> \
  --set channelServer.address=mapfs-channel.kube-system.svc.cluster.local:7777 \
  --set irsa.acknowledgePreCreatedSA=true

Requires a one-time IAM Role/ServiceAccount setup first — see the EKS quick start for full steps.

channelServer.address is required in both cases — without it, mount-daemon pods fail to start. On AWS EKS with Graviton (arm64) nodes, also add --set nodeSelector."kubernetes\.io/arch"=arm64.

Step 2: Configure a storage backend

# Generic Kubernetes: create a Secret, fill in cloud/bucket in storageclass.yaml, then:
kubectl create secret generic mapfs-cloud-creds -n kube-system \
  --from-literal=access_key=<AccessKeyID> --from-literal=secret_key=<SecretAccessKey>
kubectl apply -f storageclass.yaml

On EKS/IRSA, there's no Secret to create — fill in storageclass.yaml (already has irsa: "true") and apply it directly.

Also required:

Kubernetes 1.24+ cluster with kubectl and helm (v3+) access
A valid mapfs license (email + token, from https://mapfs.cloud/)
Outbound access to registry.k8s.io and Docker Hub (or the AWS Marketplace ECR registry, for EKS) for driver and sidecar images

See the Kubernetes quick start or EKS quick start for details, upgrades, and other cloud backends (Azure, MinIO, S3-compatible).