How To Use ObjectiveFS With On-Premise Object Stores

Enterprise Plan Feature

This guide is for release 5.0 and newer. For older releases, please refer to this guide.

ObjectiveFS supports on-premise object stores such as Ceph, Cleversafe, etc. This guide describes how to use ObjectiveFS with on-premise object stores.

What You Need


  1. Configure your object store
    Verify that your object store accepts bucket names of the form <bucket>.<object store hostname> (e.g.

  2. Configure your credentials (one-time setup)

    # mount.objectivefs config
    Enter ObjectiveFS license: <your ObjectiveFS license>
    Enter Access Key Id: <object store access key>
    Enter Secret Access Key: <object store secret key>
    Enter Default Region: http://<object store hostname> #e.g.

  3. Create a filesystem in bucket myfs

    # mount.objectivefs create myfs

  4. Mount a filesystem myfs on /mnt in the background (log output is in syslog)

    # mount.objectivefs myfs /mnt

  5. List all objectivefs filesystems

    # mount.objectivefs list

Steps for Object Stores that only support SSL connections

  1. See this guide to set up stunnel.
  2. Use the same commands as above with http_proxy pointing to your stunnel connection.



by ObjectiveFS staff, January 13, 2017
ObjectiveFS is a shared file system for OS X and Linux that automatically scales and gives you scalable cloud storage. If you have questions or article idea suggestions, please email us at

Get updates about ObjectiveFS