mountpoint-s3

(★ 5,752)

A simple, high-throughput file client for mounting an Amazon S3 bucket as a local file system.

File Explorer

  • .gitallowed
  • .gitignore
  • .gitmodules
  • Cargo.lock
  • Cargo.toml
  • deny.toml
  • LICENSE
  • lsan-suppressions.txt
  • Makefile
  • NOTICE
  • README.md
  • ruff.toml
  • rust-toolchain.toml
  • rustfmt.toml
  • vendor-fuser.sh

# Installation Guide

rust
Prerequisites

Setup Steps

wget https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm

Download the latest RPM package.

sudo yum install -y ./mount-s3.rpm

Install the downloaded package.

mount-s3 amzn-s3-demo-bucket /path/to/mount

Mount the Amazon S3 bucket to a local directory.

Key Commands

cargo build --release

Build the source code in release mode.

cargo test

Run the project tests.

mount-s3 amzn-s3-demo-bucket /path/to/mount

Mount an S3 bucket as a file system.

umount /path/to/mount

Unmount the mounted S3 bucket.

Valid AWS credentials (IAM role or environment variables) must be configured.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

umount

View Details ▼

Unlink a filesystem from its mount point, making it no longer accessible.
A filesystem cannot be unmounted when it is busy.

umount {{path/to/device_file}}

Unmount a filesystem, by passing the path to the source it is mounted from:

sudo umount {{path/to/device_file}}

Unmount a filesystem, by passing the path to the source it is mounted from:

umount {{path/to/mounted_directory}}

Unmount a filesystem, by passing the path to the target where it is mounted:

🔍

vim

View Details ▼

Vim (Vi IMproved), a command-line text editor, provides several modes for different kinds of text manipulation.
Pressing `<i>` in normal mode enters insert mode. Pressing `<Esc>` goes back to normal mode, which enables the use of Vim commands.
See also: `vimdiff`, `vimtutor`, `nvim`, `gvim`.

vim {{path/to/file}}

Open a file:

vim +{{line_number}} {{path/to/file}}

Open a file at a specified line number:

<:>help<Enter>

View Vim's help manual:

🔍

apt-get

View Details ▼

Debian and Ubuntu package management utility.
Search for packages using `apt-cache`.
It is recommended to use `apt` when used interactively in Ubuntu versions 16.04 and later.

sudo apt-get update

Update the list of available packages and versions (it's recommended to run this before other `apt-get` commands):

sudo apt-get install {{package}}

Install a package, or update it to the latest available version:

sudo apt-get remove {{package}}

Remove a package:

🔍

dnf install

View Details ▼

Install packages on Red Hat-based distributions.

sudo dnf {{[in|install]}} {{package1 package2 ...}}

Install packages by name:

sudo dnf {{[in|install]}} {{path/to/file}}

Install a package from a local file:

sudo dnf {{[in|install]}} {{https://example.com/package.rpm}}

Install a package from the internet:

🔍

x86_64

View Details ▼

This command is an alias of `setarch x86_64`.

tldr setarch

View documentation for the original command:

🔍

yum

View Details ▼

This command is an alias of `dnf` on modern distros.
For older distros (e.g. CentOS 7), `yum` is a distinct program from `dnf`. Some subcommands and options may be different.

tldr dnf

View documentation for the original command:

# Project Badges

// repository documentation