How To Set Up ObjectiveFS With Minio

This guide covers the steps to set up your ObjectiveFS filesystem with MinIO object store.

A. Set Up MinIO

  1. Download and install the MinIO Server.

  2. Set up DNS for your test domain and *
    a. Make sure these domains resolve to the IP address of your MinIO server when queried through the DNS server specified in /etc/resolv.conf.
    b. In this guide, we use as the test domain. You can replace any reference to with your own test domain.

  3. Start the MinIO server.
    This example uses port 8080, but you can replace it with any free port.

    # minio server –address /tmp/minio

B. Set Up ObjectiveFS

  1. Download and install ObjectiveFS.

  2. Configure objectivefs and set AWS_DEFAULT_REGION to

    $ sudo mount.objectivefs config
    Enter ObjectiveFS license: <your ObjectiveFS license>
    Enter Access Key Id: <your MinIO access key>
    Enter Secret Access Key: <your MinIO secret key>
    Enter Default Region (optional):

  3. Create your filesystem (one-time only).

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

  4. Mount your filesystem.
    You need an existing empty directory to mount your file system, e.g. /ofs.
    The ObjectiveFS process will run in the background.

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


  1. You can mount this filesystem on as many servers as you wish by running steps 1, 2 and 4 (in Part B above) on each server.
  2. Each server can then read and write to the filesystem.


last updated by ObjectiveFS staff, July 7, 2019
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