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_ATTEMPTSis not a positive integer. Previously0selected 4 attempts and other invalid values were silently ignored. (#1996)
Other changes
- Fix Mountpoint failing to start with a 30 second timeout when
--cachecontains a large cache left over from a previous run. Mountpoint no longer enforces a timeout while it removes the old cache, so starting can take as long as the removal does, and it prints a warning if the removal takes longer than 30 seconds. The rest of the mount still fails if it makes no progress for 30 seconds. (#2024) - Detect the EC2 instance type from the instance's DMI tables before querying IMDS. Where IMDS is disabled or unreachable, the default target throughput now matches the instance's network bandwidth instead of falling back to 10 Gbps. This can increase memory and network usage; use
--maximum-throughput-gbps 10to keep the previous target. (#2006) - Add the unstable
UNSTABLE_MOUNTPOINT_DISABLE_RETRY_QUOTAenvironment variable. When set totrue, Mountpoint keeps retrying throttled requests up to the maximum number of attempts even while S3 keeps throttling, instead of failing them without retrying once its retry quota runs out. See the configuration documentation. (#2032) - Fix
AWS_MAX_ATTEMPTS=1still retrying failed S3 requests up to 3 times. (#1996) - Fix Mountpoint failing to start when
AWS_MAX_ATTEMPTSis set to more than 64. (#2010) - Use a single event loop thread to query the EC2 instance metadata service (IMDS) at startup, instead of a number of threads that scales with the CPU count. (#2034)
- Fix memory allocator background threads not running when Mountpoint runs in background mode (the default, without
--foreground). These threads return freed memory to the operating system, which otherwise happens on the threads serving file system requests. (#1999) - Fix S3 CRT client metrics (
s3.client.*) not updating on every metrics publication cycle for requests lasting longer than five seconds. These gauges are now sampled when metrics are published, rather than only when a new S3 request starts. (#1957 by @ziwon) - Fix files and directories created through Mountpoint being reported as missing after an earlier lookup of the same name failed, when negative metadata caching is enabled (
--metadata-ttlor--negative-metadata-ttl). Lookups could returnENOENTuntil the negative cache entry expired once the kernel had forgotten the new inode. (#1985 by @samridh10exe) - Fix existing directories incorrectly appearing as missing when S3 returns an empty page of listing results. (#1954 by @cayoub-oai)
- Fix directory listings ending early when S3 returns an empty page of listing results.
readdirnow keeps listing until it finds entries or reaches the last page. (#2023 by @Manishram-ai) - Fix a deadlock that could make the file system hang when the kernel forgets a file or directory while another file in the same directory is renamed, or while the directory is opened for listing with files still being written in it. (#1995)
- Make
--incremental-uploadconsistently check for concurrent writes when appending (i.e. withoutO_TRUNC), even at offset 0. Previously, appending to an existing empty object could silently overwrite another writer's changes instead of failing withEIO. (#1970 by @yerzhan7) - Update the internal S3 client to use the latest release of the AWS Common Runtime (CRT) libraries. (#1967, #2010, #2020)
Binaries
x86_64
- RPM: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.rpm
- RPM signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.rpm.asc
- RPM (SUSE): https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.suse.rpm
- RPM (SUSE) signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.suse.rpm.asc
- DEB: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.deb
- DEB signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.deb.asc
- tar.gz: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.tar.gz
- tar.gz signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/x86_64/mount-s3-1.25.0-x86_64.tar.gz.asc
arm64
- RPM: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.rpm
- RPM signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.rpm.asc
- RPM (SUSE): https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.suse.rpm
- RPM (SUSE) signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.suse.rpm.asc
- DEB: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.deb
- DEB signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.deb.asc
- tar.gz: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.tar.gz
- tar.gz signature: https://s3.amazonaws.com/mountpoint-s3-release/1.25.0/arm64/mount-s3-1.25.0-arm64.tar.gz.asc