awslabs /mountpoint-s3
A simple, high-throughput file client for mounting an Amazon S3 bucket as a local file system.
★ 5,796⑂ 256👁 44⑃ 1,593● 440▤ 41
More from this author
-1
Daily
5,796
stars
256
forks
44
watchers
1,593
prs
440
issues
41
releases
README
Mountpoint for Amazon S3
Mountpoint for Amazon S3 is a simple, high-throughput file client for mounting an Amazon S3 bucket as a local file system. With Mountpoint for Amazon S3, your applications can access objects stored in Amazon S3 through file operations like open and read. Mountpoint for Amazon S3 automatically translates these operations into S3 object API calls, giving your applications access to the elastic storage and throughput of Amazon S3 through a file interface.
Mountpoint for Amazon S3 is optimized for applications that need high read throughput to large objects, potentially from many clients at once, and to write new objects sequentially from a single client at a time. This means it's a great fit for applications that use a file interface to:
read large objects from S3, potentially from many instances concurrently, without downloading them to local storage first
access only some S3 objects out of a larger data set, but can't predict which objects in advance
upload their output to S3 directly, or upload files from local storage with tools like cp
but probably not the right fit for applications that:
use file operations that S3 doesn't natively support, like directory renaming or symlinks
make edits to existing files (don't work on your Git repository or run vim in Mountpoint 😄)
Mountpoint for Amazon S3 does not implement all the features of a POSIX file system, and there are some differences that may affect compatibility with your application. See Mountpoint file system behavior for a detailed description of Mountpoint for Amazon S3's behavior and POSIX support and how they could affect your application.
To troubleshoot file operations that may not be supported by Mountpoint, see the troubleshooting documentation.
Current status
Mountpoint for Amazon S3 is generally available! We're tracking future feature development on the Mountpoint for Amazon S3 public roadmap. We're always interested in feedback on features, performance, and compatibility. Please send feedback by opening a new GitHub issue or adding your input to an existing roadmap issue.
Notices
[!IMPORTANT]
Mountpoint for Amazon S3 v1.4.0, released on January 26, 2024, contains an issue that causes intermittent read failures. We recommend that customers using v1.4.0 upgrade to v1.4.1 or later.
Getting started
On Amazon Linux 2023, you can install Mountpoint for Amazon S3 directly from the repository:
sudo dnf install mount-s3
On other RPM-based distributions (Fedora, CentOS, RHEL; excluding SUSE), run these two commands to install Mountpoint for Amazon S3 on your EC2 instance (for Graviton instances, replace x86_64 with arm64 in the URL):
wget https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm
sudo yum install -y ./mount-s3.rpm
On Ubuntu, use these commands instead (for Graviton instances, replace x86_64 with arm64 in the URL):
wget https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb
Top issues
#154Windows support50 comments · 2023-03-15#927Unable to configure Mountpoint with IAM Roles Anywhere26 comments · 2024-06-28#450Support for AWS Fargate / mount failed on ECS Fargate22 comments · 2023-08-11#369Add ML benchmarks13 comments · 2023-07-13#1174Support emulation of file rename12 comments · 2024-11-19#656Mount S3 inside a Lambda function12 comments · 2023-11-30#502Memory usage keeps increasing on md5sum compute12 comments · 2023-09-06#444macOS support12 comments · 2023-08-10
Discussions
#1804Relationship to new "S3 Files"0 comments · 2026-04-08#1761Mountpoint Updates Jan 2026 and Feedback Wanted!0 comments · 2026-01-30#1670Reading large objects from Glacier Instant Retrieval1 comments · 2025-10-23
Latest release
mountpoint-s3 v1.25.0 mountpoint-s3-1.25.0 2026-11-12Breaking changes Amazon Linux 2 reached end of support on June 30, 2026 and is no longer tested. Mountpoint for Amazon S3 releases may continue to install and run on it, but we recommend upgrading to Amazon Linux 2023. (2033) Mountpoint now fails to start when AWS_MAX_ATTEMPTS is not a positive integer. Previously 0 selected 4 attempts and other invalid values were silently ignored. (1996) Other changes Fix Mountpoint failing to start with a 30 second timeout when --cache contains a large cache left over from a previous run. Mountpoint no longer enforces a timeout while it removes