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, e.g. and *
    Make sure these domains resolve to the IP address of your MinIO server when queried through the DNS server specified in /etc/resolv.conf.

  3. Start the MinIO server.

    # MINIO_DOMAIN=<your test domain> minio server /tmp/minio

B. Set Up ObjectiveFS

  1. Download and install ObjectiveFS.

  2. Configure ObjectiveFS.

    $ 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): http://<your test domain>:9000

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

    $ sudo mount.objectivefs create <your filesystem name>
    Passphrase (for http://<your test domain>:9000/<filesystem>): <your passphrase>
    Verify passphrase (for http://<your test domain>:9000/<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 http://<your test domain>:9000/<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, May 4, 2021

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