Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Configuring S3

  2 minute read.

Last Modified 2022-05-24 09:28 EDT

This tutorial describes how to start a local S3 service on TrueNAS and connect to it from a networked client system with the MinIO Browser, s3cmd, and S3 Browser.

S3 is an object storage protocol used by many major cloud providers including Amazon Web Services™. On TrueNAS, the service is another way to store files, you can view with a web browser. Because S3 is the de facto standard for cloud-based storage, setting up an S3 service allows organizations or online application developers to use TrueNAS to replace or archive expensive cloud storage.
Having large numbers of files (>100K for instance) in a single bucket with no sub-directories can harm performance and cause stability issues.

Setting up the S3 service

Go to the Services page and find the S3 on the list.

ServicesS3Enable

Click the toggle to stop the service if it is running. Select Start Automatically to start the service when TrueNAS boots.

Click the to configure the service.

ServicesS3Options

See S3 screen for information on settings.

The IP address 0.0.0.0 allows the service to listen on any IPv4 address. :: allows the same for any IPv6 address. Select the TrueNAS IP address to constrain it to a specific network.

Select a clean dataset. If there is no dataset, click CANCEL and then go to Storage > Pools and clicking > Add Dataset. Files are managed by MinIO as objects, and cannot be mixed with other dataset files.

Configure the rest of the options as needed in your environment. Make sure to start the service after saving any changes.

Additional Information

S3 screen

S3 for MinIO