Skip to main content

EFS mount requirements

EFS mounts require a supported Linux environment with FUSE available.

The supported target is a Morph-managed Linux VM/devbox, or an equivalent FUSE-capable Linux host. A supported host provides:

  • Linux with FUSE support enabled.
  • A usable /dev/fuse device.
  • fusermount3 available in the environment.
  • Permission for the current user to create a FUSE mount.

EFS does not install OS packages, run package managers, or run sudo during normal user workflows. If the target host is not ready for an EFS mount, the client fails fast with a clear Morph EFS message instead of attempting to mutate the machine.

Each host that mounts EFS must meet these requirements independently. If you mount the same filesystem from two hosts, both hosts need Linux FUSE support and permission for the current user to create a FUSE mount.

These requirements apply to the host where you want the mount path to appear. Morph manages the rest of the mount infrastructure behind the product API.

Default mount path​

The default command:

morphcloud efs mount shared-files

mounts at:

~/morph-efs/shared-files

The command starts the mount in the background and returns when the path is ready.

Explicit mount path​

Pass a path as the second argument when you want to choose the mount location:

mkdir -p /tmp/shared-files
morphcloud efs mount shared-files /tmp/shared-files

Unmount by filesystem name or id:

morphcloud efs unmount shared-files

Unsupported hosts​

On unsupported hosts, the client reports that the machine is not ready for Morph EFS mounts and directs you to use a supported Morph-managed environment or contact support.

Common causes are:

  • The host is not Linux.
  • /dev/fuse is missing.
  • fusermount3 is missing.
  • The current user cannot create FUSE mounts.

If you are preparing your own compatible host, install and validate FUSE support outside the EFS command path before running morphcloud efs mount.

For general MorphVM FUSE background, see Running FUSE on MorphVMs. That page covers generic FUSE setup. EFS itself still expects the mount prerequisites to already be present.