Set Up ObjectiveFS (v.6.9.1 and older)

This document covers the steps to set up your ObjectiveFS filesystem for ObjectiveFS versions older than 7.0. For versions 7.0 and newer, see this doc.

What You Need

  1. S3 or GCS access and secret keys or IAM role attached to your EC2 instance
  2. ObjectiveFS license key from the Filesystem section on your profile page
  3. ObjectiveFS software installed on your machine (see Quick Start)


  1. Configure Objectivefs
    a. Using Keys

    $ sudo mount.objectivefs config
    Enter ObjectiveFS license: <your ObjectiveFS license>
    Enter Access Key Id: <your access key>
    Enter Secret Access Key: <your secret key>
    Enter Default Region (optional): <your region, e.g. eu-west-1>
    b. Using IAM Role
    $ sudo mount.objectivefs config -i
    Enter ObjectiveFS license: <your ObjectiveFS license>
    Enter Metadata Host []: <press enter>
    Enter Default Region (optional): <your S3 region, e.g. eu-west-1>
    Note: This will use the default AWS metadata host at

  2. Create your filesystem (one-time only)

    • Choose a unique filesystem name. ObjectiveFS will create a new bucket with this name.
    • Choose a strong passphrase, write it down and store it somewhere safe.
      IMPORTANT: Without the passphrase, there is no way to recover any files.

    $ sudo mount.objectivefs create <your filesystem name>
    Passphrase (for <filesystem>): <your passphrase>
    Verify passphrase (for <filesystem>): <your passphrase>

  3. Mount your filesystem
    Mount your filesystem on an existing empty directory, e.g. /ofs. The ObjectiveFS process will run in the background.

    $ sudo mkdir /ofs
    $ sudo mount.objectivefs <your filesystem name> /ofs
    Passphrase (for //<filesystem>): <your passphrase>

  4. [Optional] Multi-server setup
    Mount this filesystem on as many servers as you wish by running steps 1 and 3 on each server after installing ObjectiveFS. Each server can read and write to the same filesystem at the same time.

If you have questions, please email us at

Last updated by ObjectiveFS staff, October 2, 2022

ObjectiveFS is a shared filesystem for Linux and macOS that automatically scales up and out with high performance. In production use by Fortune 500 companies since 2013.