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
RustApache-2.0Created 2022-08-22
下载:mountpoint-s3 v1.25.0mountpoint-s3-1.25.0 ↓1.25.02026-11-12
-1
日增长
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

Discussions

Latest release

mountpoint-s3 v1.25.0 mountpoint-s3-1.25.0 2026-11-12
Breaking 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 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON