Getting started with File Store

This guide walks you through creating a File Store instance and mounting it on a Virtual Machine (VM). You'll learn how to create the File Store, verify it's ready, and mount it using the standard Linux NFS client.

Prerequisites

Before you begin, you'll need:

  • An evroc account with appropriate IAM permissions.
  • The evroc CLI installed and logged in. For instructions, see getting started.
  • A virtual machine (VM) running in the same zone as where you'll create the File Store.

Create a File Store

To create a File Store, use the storage filestore create command. You'll need to specify a unique ID for your File Store and the availability zone where it should be deployed.

# Create a File Store in zone se-sto-a
evroc storage filestore create my-filestore --zone se-sto-a

If successful, the CLI responds with:

created

Note: File Store names must be unique within your project and can only contain lowercase letters, numbers, and hyphens.

Verify the File Store is ready

After creation, the File Store goes through a provisioning phase. To check its status, use the get command:

evroc storage filestore get my-filestore

The output includes the status information:

kind: FileStore
apiVersion: storage/v1
metadata:
  id: my-filestore
  uid: 8f4e2c9d-1a3b-4c5d-6e7f-8a9b0c1d2e3f
  project: my-project
  region: se-sto
spec:
  protocol: NFS
  placement:
    zone: se-sto-a
  nfs:
    version: V4.1
status:
  status: Available
  protocol: NFS
  nfs:
    version: V4.1
    endpoint: 10.100.0.10
    exportPath: /
  placement:
    zone: se-sto-a
  conditions:
    - type: Ready
      status: "True"
      reason: Ready
      message: FileStore is ready for use
      lastTransitionTime: "2026-05-19T10:30:00Z"

Look for the Ready condition with status "True". This indicates the File Store is fully provisioned and ready to mount. The endpoint field shows the IP address you'll use for mounting.

Note: Provisioning typically takes a couple of minutes. If the status shows Provisioning, wait a moment and check again.

Mount the File Store on a VM

Once your File Store is available, it's accessible to all VMs in your project's VPC.

Note: While you can mount a File Store from a VM in a different zone (within the same region/VPC), performance isn't guaranteed. Cross-zone traffic traverses the regional network and may experience higher latency.

Prerequisites on the VM

Ensure the VM has the NFS client installed:

For Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y nfs-common

For RHEL/CentOS/Rocky Linux:

sudo yum install -y nfs-utils

Mount the file system

  1. Create a mount point:

    sudo mkdir -p /mnt/filestore

  2. Mount using the endpoint IP and export path from the File Store status:

    # Replace `<filestore-endpoint>` with your File Store's endpoint IP
sudo mount -t nfs4 -o nfsvers=4.1 <filestore-endpoint>:/ /mnt/filestore

  3. Verify the mount:

    df -h | grep filestore
# Output: 10.100.0.10:/  100G   10G   90G  10% /mnt/filestore

Configure automatic mount on boot

To automatically mount the File Store when the VM boots, add an entry to /etc/fstab:

# Replace `<filestore-endpoint>` with your File Store's endpoint IP
echo "<filestore-endpoint>:/ /mnt/filestore nfs4 nfsvers=4.1,_netdev,rsize=1048576,wsize=1048576 0 0" | \
  sudo tee -a /etc/fstab

The _netdev option ensures the mount waits for the network to be available before attempting to mount.

Test the File Store

Create a test file to verify the mount is working:

# Create a test file
echo "Hello from evroc File Store" | sudo tee /mnt/filestore/test.txt

# Read it back
cat /mnt/filestore/test.txt
# Output: Hello from evroc File Store

# List the file
ls -la /mnt/filestore/
# Output: -rw-r--r-- 1 root root 28 May 19 10:35 test.txt

Unmount the File Store

When you no longer need the File Store mounted:

sudo umount /mnt/filestore

If the File Store is being used, you may need to stop any processes accessing it first:

# Find processes using the mount
lsof /mnt/filestore

# Stop those processes, then unmount
sudo umount /mnt/filestore

Clean up

To delete the File Store when you no longer need it:

Warning: Deleting a File Store permanently removes all data stored on it. This action can't be undone.

evroc storage filestore delete my-filestore

You'll be prompted to confirm:

Are you sure (y/n)?

After confirmation, the File Store enters a deleting state and is permanently removed.

Next steps