troubleshooting-efs

Diagnose and resolve Amazon EFS issues with structured troubleshooting steps.

2.3k|234|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-efs-aws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-efs
Source: https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/storage-skills/troubleshooting-efs
Command: npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-efs-aws

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and resolves Amazon EFS issues including mount failures, NFS connectivity, IAM and POSIX permissions, throughput and performance, and encryption problems.

Core Features & Use Cases

  • Classify issues by symptom (mount failures, timeouts, permission errors, encryption issues) and map them to remediation categories.
  • Provide practical steps to install necessary NFS clients, verify mount targets, test connectivity, and validate IAM/resource policies.
  • Use case examples: when a file system won't mount due to security groups or IAM restrictions, or when throughput is suboptimal in bursting mode.

Quick Start

Describe the issue you are facing and I will guide you through validating dependencies, identifying root causes, and applying a safe remediation plan.

Frequently Asked Questions about troubleshooting-efs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Amazon EFS mount failures in my AWS VPC?

To fix Amazon EFS mount failures, verify NFS client dependencies, check mount target configurations, and test VPC network reachability. This process systematically validates security groups and connectivity to isolate and resolve the underlying issue.

Why does my EFS mount time out when connecting via NFS?

EFS mount timeouts typically occur due to blocked network traffic or missing mount targets. Troubleshooting involves checking security group ingress rules, verifying VPC route tables, and confirming the NFS client is correctly installed and communicating with the target.

How do I resolve IAM permission denied errors for Amazon EFS?

Resolving IAM permission denied errors on EFS requires validating both IAM resource policies and POSIX file system permissions. The diagnostic process checks identity-based policies, file system resource policies, and POSIX user mappings to ensure authorized access.

What is the best way to troubleshoot suboptimal EFS throughput in bursting mode?

The best way to troubleshoot suboptimal EFS throughput in bursting mode is to analyze file system performance metrics and validate bursting credit balances. This identifies whether throughput limitations stem from workload patterns or capacity configurations.

Does this EFS troubleshooting guidance cover encryption edge cases?

Yes, this EFS troubleshooting guidance covers encryption edge cases. It diagnoses encryption problems by enforcing checks on dependencies and validating configurations to ensure encrypted file systems mount and operate correctly within your VPC.

What prerequisites do I need to check before mounting an EFS file system?

Before mounting an EFS file system, ensure the NFS client is installed, mount targets are created in the correct subnets, and security groups allow inbound traffic. These prerequisite checks prevent common mount failures and connectivity errors.