Skip to main content


Filesystem Caveats

Please note that that a mounted Object Storage bucket doesn't always behave like a normal POSIX file system. Depending on how your application is accessing files, you may encounter issues like:

  • no/wrong file system usage statistics
  • sub-par performance
  • unexpected unmounts
  • duplicate writes leading to hidden objects that occupy space but are invisible to S3 API requests

If possible, using other tools like rclone to access Object Storage is recommended.

Goofys is another S3 file system tool for Linux and macOS. It provides the same functionality as s3fs-fuse but with better performance.

Please follow the installation instruction like described on Installation

On Linux systems, make sure package fuse-utils is installed and run:

sudo install goofys /usr/local/bin/

All you will need is:

  • access_key
  • secret_key
  • Contabo's S3 URL

For access_key, secret_key and the S3 URL please check here.


Either follow the steps from aws-cli to configure an endpoint in ~/.aws/credentials or create the file manually:



# create mount point
mkdir ${HOME}/foo
# mount bucket foo to ${HOME}/foo
goofys --endpoint="" foo ${HOME}/foo

# adding an fstab entry to mount the bucket automatically at boot time
# credentials must be present in /root/.aws/credentials
sudo mkdir /mnt/foo
echo 'goofys#foo /mnt/foo fuse _netdev,allow_other,--file-mode=0666,--dir-mode=0777, 0 0' | sudo tee -a /etc/fstab