Run S3 Object Storage on FreeNAS and TrueNAS

S3 is an object storage provided by many major cloud providers including Amazon Web Services™ and is well suited for storing unstructured data like multimedia files (video, audio, photos) and big data. TrueNAS and FreeNAS run Minio object storage as a native service, allowing NAS storage to act as an S3 storage target with standard S3 APIs.

The video below and the more-detailed quick guide discuss how to set up the S3 service on FreeNAS, as well as how to connect several S3 tools to the storage.

With Plugins, Jails, Docker, VMs, S3 object storage, and cost savings of up to 80% compared to renting cloud storage, FreeNAS and TrueNAS are the perfect storage platforms for developers and web service providers.


  1. Eduard

    This procedure doesn’t work on Truenas – the access credentials are not transferred from GUI to the minio configuration text file.

    • Joe

      May need to check the version. Using 11.1U5 and beyond works and the config will work at the Minio web portal log in.

  2. Sven

    I really miss the ability to create more than one instance of Minio. Minio itself does not support multiple accesskeys/rights so you have to use multiple instances to keep permissions seperated. I know it is possible to use docker to add more instances, but it is more clean to support it directly from FreeNAS/TrueNAS.

    • Joe

      Agree with that! It is possible using the command line to create multiple instances. Since they could close when the terminal is closed, we wouldn’t recommend, but for testing purposes, in FreeNAS 11.2 you can use ‘export MINIO_ACCESS_KEY=’ ‘export MINIO_SECRET_KEY=’ then ‘minio server http://:9000/dataset‘. This is unsupported at the moment, but perfectly usable if you need to set up a few more test groups. These groups should stay in the FreeNAS even if they get closed, but again this isn’t the supported way of doing things, so do NOT recommend putting any critical data in an instance just running from command line.


    This was much easier than I thought it would be! S3 combined with a local SMB share makes my life easier but I am missing the last piece:
    How can I access the S3 storage when all development is based on the amazon-sdk? That only allows you to access the actual amazon regions.
    Am I missing something?

  4. Anthony

    What ports are necessary to open to allow devices to access the buckets from the outside.

  5. Adis

    Has anyone tried to set the certificate to the S3 service? I am running FreeNAS-11.3-RC2 not sure if it’s a bug but I cannot set the certificate. I have configured SSL for the FreeNAS UI and it’s working correctly. If anyone can give this a go and advise if it has worked for them even using the freenas_default cert. It lets you set a certificate and then save the config but when you go back into it, it has not taken/saved.

    I have tried on 2 systems which I have running both FreeNAS-11.3-RC2.

    • nicholas

      There must be a bug in 11.3RC2 as i cannot set the cert either. Have you raised in their bug tracker?

      • Adis

        Thanks for letting me know, I was thinking that I am doing something wrong.

        No I not raised the bug but I have found a previous mention of it in the bug tracker but must have been for a previous release.

  6. Bo

    Trying to present an NFS mount as S3 – any ideas how to make that work? I´m allowed to configure it but the service refuses to start. Also, as soon as I hit save the GUI throws me out and I have to login again, so there´s something crashing…

  7. Elcio

    Does anyone try to work this?
    I try using in 11.3 and with the browser it Works.
    But when you try to connect using a API, like S3 Browser it doesnt connect and send a message redirect to http://x.x.x.x:ui


Submit a Comment

Your email address will not be published. Required fields are marked *

ESG Labs: TrueNAS Technical Report

iXsystems values privacy for all visitors. Learn more about how we use cookies and how you can control them by reading our Privacy Policy.