Installation Notes

John edited this page Aug 14, 2018 · 21 revisions

General Instructions

From released tarball or zip

Download: Latest version

  tar xvzf s3fs-fuse-1.74.tar.gz
  cd s3fs-fuse-1.74/
  ./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

Tested on Ubuntu 10.10, Ubuntu 12.04.3 LTS

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

sudo apt-get install build-essential libfuse-dev fuse-utils libxml2-dev mime-support automake libtool
sudo apt-get install libcurl4-openssl-dev # See (*2) 
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

Fedora / CentOS

Tested on Fedora 14 Desktop Edition and CentOS 5.5 (Note: on Nov 25, 2010 with s3fs version 1.16, newer versions of s3fs have not been formally tested on these platforms)

Note: See the comment below on how to get FUSE 2.8.4 installed on CentOS 5.5

Install prerequisites before compiling:

yum install gcc libstdc++-devel gcc-c++ fuse fuse-devel curl-devel libxml2-devel mailcap git automake
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

Installing on Amazon Linux AMI

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

Installing on centOS 6 (s3fs version 1.74)

Please make sure you understand what this script is doing before using to make sure it won't cause any other issues. Use at your own risk.

#Run as root...
yum install -y epel
yum install -y automake fuse fuse-devel gcc-c++ git libcurl-devel libxml2-devel make openssl-devel # See (*2) 

#Can't use yum for fuse need a different version than is available (CentOS 5)

wget http://sourceforge.net/projects/fuse/files/fuse-2.X/2.8.5/fuse-2.8.5.tar.gz/download

tar zxvf fuse-2.8.5.tar.gz

cd fuse-2.8.5/ && ./configure && make && make install

echo -e '\\n/usr/local/lib' >> /etc/ld.so.conf

ldconfig

wget http://s3fs.googlecode.com/files/s3fs-1.74.tar.gz

tar zxvf s3fs-1.74.tar.gz

(cd s3fs-1.74/ && autoreconf --install && export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig && ./configure --prefix=/usr && make && 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-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

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.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.