General Instructions

From released tarball or zip

Download: Latest version

tar xvzf s3fs-fuse-1.87.tar.gz
cd s3fs-fuse-1.87/
./autogen.sh
./configure --prefix=/usr # See (*1)
make
make install (as root)

From GitHub repository

git clone https://github.com/s3fs-fuse/s3fs-fuse.git
cd s3fs-fuse/
autoreconf --install (or ./autogen.sh)
./configure --prefix=/usr # See (*1)
make
make install (as root)

Notes for Specific Operating Systems

Debian / Ubuntu

Tested on Ubuntu 14.04 LTS

Install prerequisites, clone source, configure, make and install:

sudo apt-get install build-essential git libfuse-dev libcurl4-openssl-dev libxml2-dev mime-support automake libtool
sudo apt-get install pkg-config libssl-dev # See (*3)
git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
./autogen.sh
./configure --prefix=/usr --with-openssl # See (*1)
make
sudo make install

Build .deb for Ubuntu 18.04/20.04 from within Docker

Here is a Dockerfile which will build a .deb package for s3fs based on a given commit. The resulting files are also available for download.

Fedora / CentOS / RHEL / Rocky Linux / AlmaLinux / etc

Version 8 or newer (including Fedora)

Tested on Rocky Linux 8

dnf install gcc libstdc++-devel gcc-c++ fuse3 fuse3-devel curl-devel libxml2-devel mailcap git automake make
dnf install openssl-devel # See (*2)
git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
./autogen.sh
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
./configure --prefix=/usr --with-openssl # See (*1)
make
sudo make install

Version 7

WARNING: s3fs 1.97 stared requiring FUSE3 and gcc-c++ >= 6.1.0. FUSE3 is provided by the "extra" repositories, and you can get a gcc-c++ version recent enough from the Software Collection repository. Be aware, however, that future versions of s3fs could break the support for CentOS7 and you are strongly encouraged to upgrade your OS.

sed -i -e '/^mirrorlist/d;/^#baseurl=/{s,^#,,;s,/mirror,/vault,;}' /etc/yum.repos.d/CentOS*.repo # You need the vault repositories, as the old repositories are gone
yum install gcc libstdc++-devel gcc-c++ fuse3 fuse3-devel curl-devel libxml2-devel mailcap git automake make
yum install openssl-devel # See (*2)
yum install centos-release-scl-rh # Install the software collection repository
sed -i -e '/^mirrorlist/d;/^#baseurl=/{s,^#,,;s,/mirror,/vault,;}' /etc/yum.repos.d/CentOS-SCLo-scl-rh.repo  # Change the software collection repository to use the vault as well
yum install devtoolset-7 # devtoolset-7, includes also a gcc version recent enough.
git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
export CXX=/opt/rh/devtoolset-7/root/usr/bin/g++ # Use gcc-c+ from devtoolset-7
./autogen.sh
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
./configure --prefix=/usr --with-openssl # See (*1)
make
sudo make install

NOTE: On paper CentOS7 has a newer gcc-c++ available via devtoolset-7, but still it fails to build. If you find how to fix it, feel free to update this wiki.

Version 6 (s3fs version >= 1.74)

WARNING: s3fs 1.87 removed the support for RHEL6/CentOS6. If you want to use s3fs on RHEL/CentOS6 the last version you can compile is 1.86

s3fs versions from 1.74 require at least fuse equal or newer than 2.8.4, which is not available at RHEL6/CentOS 6 as they provide 2.8.3 (and neither RHEL5/CentOS 5 as they provide 2.7.4). See issues #42 and #279 for details.

That means you need to build and install a newer version of fuse.

The following commands will install fuse 2.8.4, but please make sure this is not a problem for your system, and keep in mind you are doing this on your own.

Run as root:

yum install -y gcc libstdc++-devel gcc-c++ curl-devel libxml2-devel mailcap git automake make wget # fuse and s3fs prerequisites
yum install openssl-devel # See (*2)
wget https://github.com/libfuse/libfuse/releases/download/fuse_2_9_4/fuse-2.8.4.tar.gz
tar zxvf fuse-2.8.4.tar.gz
cd fuse-2.8.4/ && ./configure && make && make install
echo -e '\\n/usr/local/lib' >> /etc/ld.so.conf
ldconfig

Note: If s3fs command execution results in following message with “s3fs: error while loading shared libraries: libfuse.so.2: cannot open shared object file: No such file or directory”, you need to yum install fuse-libs

Now you can compile in the same way you would do for RHEL7/CentOS 7, but adding an extra line (export) to point configure to the fuse package we compiled above:

git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
git checkout v1.86
./autogen.sh
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
./configure --prefix=/usr --with-openssl # See (*1)
make
sudo make install

As an alternative you can build and install RPMs for both fuse and latest stable version for s3fs by using the GitHub repository that is source for the Fedora and EPEL (CentOS/RHEL) s3fs-fuse packages.

Amazon Linux

sudo sed -i 's/enabled=0/enabled=1/' /etc/yum.repos.d/epel.repo
sudo yum install -y gcc libstdc++-devel gcc-c++ fuse fuse-devel curl-devel libxml2-devel mailcap automake openssl-devel git
git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
./autogen.sh
./configure --prefix=/usr --with-openssl
make
sudo make install

SUSE and openSUSE

Installing experimental packages

If the official package is old and you want a more recent version (not officially supported!), then check experimental versions at https://software.opensuse.org/package/s3fs, and then choose one of three alternatives:

1. Use the 1 Click Install button (easiest option, but only works when using GUI).

2. Download the RPM package from website above (Download button) and install it with sudo rpm -i

3. Install the filesystem repository for any of the supported OS at https://download.opensuse.org/repositories/filesystems/: Browse inside the folder for your OS, right click on the filesystems.repo file, and use it with zypper ar. For example for openSUSE 42.3:

   zypper ar https://download.opensuse.org/repositories/filesystems/openSUSE_Leap_42.3/filesystems.repo
   

   Then install the package normally:

   sudo zypper in s3fs
   

Compiling sources

Tested on openSUSE Leap 42.3 and Leap 15.0. Should work as well on any SUSE >= 12 or any openSUSE >= 42.1

Install prerequisites, clone source, configure, make and install:

sudo zypper in -y automake curl-devel fuse fuse-devel gcc-c++ libxml2-devel make openssl-devel
git clone https://github.com/s3fs-fuse/s3fs-fuse
cd s3fs-fuse/
./autogen.sh
./configure --prefix=/usr/local --with-openssl # See (*1)
make
sudo make install

This will install the executable at /usr/local/bin/s3fs, and the man page at /usr/local/share/man/man1/s3fs.1

Mac OSX

Assuming you have installed Homebrew, you'll need to install these dependency packages:

• macfuse
• automake
• gcc
• curl
• libxml2
• pkg-config
• openssl

And as noted in the output of the openssl install, you'll need to set these environment variables:

  export LDFLAGS="-L/usr/local/opt/openssl@3/lib"
  export CPPFLAGS="-I/usr/local/opt/openssl@3/include"
  export PKG_CONFIG_PATH="/usr/local/opt/openssl@3/lib/pkgconfig"

Depending on where Homebrew was installed, the /usr/local path above should be replaced with /opt/homebrew. Please check your Homebrew environment and replace the above.

Then you should be able to follow the standard compilation instructions.

Users on Apple Silicon M1 Macs have reported the need to ensure that the terminal is not opened using Rosetta. If you're unsure, it's probably safe to try compiling anyway. If compilation fails with an error like "ld: symbol(s) not found for architecture x86_64" then you may need to investigate disabling Rosetta.

Explanatory note

Common for building(*1, *2)

Latest master branch supports three libraries about SSL, those are OpenSSL, NSS and GnuTLS(gcrypt and nettle). You should use the library as same as that is linked in libcurl. The libcurl supports OpenSSL, NSS, GnuTLS etc, you should confirm which library is linked by libcurl. (ex. "curl --version" command shows libcurl types and version.)

(*1) You can specify following configure option:

• Use OpenSSL --with-openssl(default)
• Use NSS --with-nss
• Use GnuTLS --with-gnutls(or --with-gnutls --with-nettle)

(*2) Depending on a library to use, please install the developer package.

(*3) Some OS(ubuntu 14.10 etc) needs these packages.

From conda-forge

The conda-forge project provides an open-source package management ecosystem, written mostly in Python.

The most efficient method to get s3fs is to install Mambaforge. Then run

mamba install -c conda-forge s3fs-fuse

Alternatively, install Anaconda, Miniconda, or Miniforge, and run

conda install -c conda-forge s3fs-fuse

Any issues should be reported to the conda-forge s3fs-fuse feedstock.