Why can't I mount my EFS file system on my EC2 instance?

Resolution

You might not be able to mount your file system on your Amazon EC2 instance for multiple reasons. For a list of mount issues and resolutions, see Troubleshooting mount issues.

To mount your EFS file system, your instance must meet the prerequisites. To confirm that your instance meets the prerequisites, run the AWSSupport-CheckAndMountEFS AWS Systems Manager Automation document.

Before you run the automation, make sure that your AutomationAssumeRole has the correct Identity and Access Management (IAM) permissions. For more information, see the Required IAM permissions section of AWSSupport-CheckAndMountEFS. To create a service role for Automation, see Create a service role for Automation.

To run the automation document, complete the following steps:

1. Navigate to the AWSSupport-CheckAndMountEFS runbook on the AWS Systems Manager console.
2. On the Execute automation runbook page, for Input parameters, enter the following information:
   (Optional) For AutomationAssumeRole, enter the ARN of the role for the automation to perform the actions for you.
   For InstanceId, enter the ID of the instance that you want to mount the file system on.
   For EfsId, enter the ID of the file system that you want to mount.
   For Region, enter the AWS Region where the instance and file system are located.
   For Action, choose Check to verify only the prerequisites. Or, choose CheckandMount to verify the prerequisites and mount the file system.
   (Optional) For MountTargetIP, enter the mount target's IP address.
   Note: In environments where DNS is turned off, you can use your IP address to mount. You can also use this option if your environment uses a DNS provider other than Amazon Route 53.
   (Optional) For MountOptions, choose the options that you want to use when you mount the file system. If you specify the tls option, then make sure to upgrade stunnel for your target instance.
   (Optional) For MountPoint, enter the directory where you want to mount the file system.
   Note: If you choose Check for the Action field, then don't enter a directory.
3. Choose Execute.

After the automation is complete, review the Outputs section for detailed results.

Related information

Run an automation

Setting up Automation

Systems Manager Automation runbook reference