Set Up ObjectiveFS With Microsoft Azure

This document covers the steps to set up your ObjectiveFS filesystem with Microsoft Azure.

What You Need

  1. Your Azure Storage Account is set up
  2. ObjectiveFS license key from the Filesystem section on your profile page
  3. Contact to enable Azure access on your account


  1. Download and install ObjectiveFS package for Azure

  2. On your Azure account, verify Disabled is selected for Secure transfer required (ObjectiveFS has built-in client side encryption already).

    Azure Portal
    → Storage accounts
    → Under Settings, select Configuration
    → For “Secure transfer required”, select “Disabled”

  3. Configure Objectivefs
    The config parameters will be stored in /etc/objectivefs.env/

    $ sudo mount.objectivefs config
    Enter ObjectiveFS license: <your ObjectiveFS license>
    Enter Access Key Id: <your Azure storage account name>
    Enter Secret Access Key: <Access key from your Azure storage account>
    Enter Default Region: http://<storage account name>
    Verify the following in /etc/objectivefs.env:

    • AWS_DEFAULT_REGION contains http://<your storage account name>
    • AWS_ACCESS_KEY_ID contains your Azure storage account name
    • AWS_SECRET_ACCESS_KEY contains the access key from your storage account

  4. Create your filesystem (one-time only)

    • Use a globally unique name for your filesystem name. ObjectiveFS will create a new Azure bucket with this name in the region of your Azure storage account.
    • 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 http://<acctname><filesystem>): <your passphrase>
    Verify passphrase (for http://<acctname><filesystem>): <your passphrase>
    Note: If you need to use an existing empty Azure bucket, see this doc.

  5. 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 http://<acctname><filesystem>): <your passphrase>

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


  1. Store your filesystem passphrase in /etc/objectivefs.env/OBJECTIVEFS_PASSPHRASE to mount the filesystem without manually entering the passphrase each time.
  2. To mount the filesystem via /etc/fstab, see the mount on boot guide.


If you have questions, please email us at

Last updated by ObjectiveFS staff, May 4, 2021

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.