1. Home
  2. admin
  3. storage
  4. adding
  5. s3 compatible

Roles

These are the roles that are needed:

  • Admin
  • Read storage
  • Write storage
  • Reindex storage

Links

Adding S3 Compatible Storage

We support the S3 protocol for storage, and storages that correctly implement the S3 API can be used with iconik. For example:

  • Backblaze B2 (though we prefer to use the in-built support from iconik for B2)
  • Cloudian
  • IBM Cloud Object Storage
  • Object Matrix
  • Wasabi
  • Others that implement the full S3 API

Prepare for adding the storage.

To start with please ensure you have the following details ready to configure your S3 storage (Your administrator of the S3 compatible storage should be able to provide these if you don't have them):

  • Access Key
  • Secret Key
  • Bucket Name
  • Region
  • End Point

If you are setting up a third party bucket we strongly recommend you read our knowledgebase article Controlling Costs as using iconik with third party buckets may cause costs for you.

Where to add storage

  1. Click on ADMIN in the top navigation.
  2. Choose Storages from the left navigation bar.
  3. Click on + NEW STORAGE to open the form to create a storage.

iconik aws storage configuration

Start filling out the parameters

  1. Choose the purpose for the storage.
    • Files - for general storage of files.
    • Keyframes - The storage stores only keyframes generated by iconik.
    • Proxies - The storage stores only proxies generated by iconik
    • Export - The storage is a destination for export jobs.
    • Archive - The storage is an archive destination.
  2. Select Amazon S3 as the Storage Type
  3. Input your Access Key, Secret Key and Bucket name.
  4. Optionally add a root Path if you don't want iconik to use the whole storage.
  5. Add the Region for where the storage bucket is located
  6. Enter in the end point in the EndPoint field
  7. Make sure that Use Acceleration is turned OFF.
  8. Add unique id to the filenames - turn this on to avoid filename collisions. This setting will be inactive for archive storages - and the filename will be kept as it is on the source storage
  9. Select Read if you want iconik to be able to read files on the storage.
  10. Select Write if you want iconik to be able to write files to the storage.
  11. Select Delete if you would like iconik to have the ability to delete files on this storage. Please note, that if this is set to true, that when an asset is deleted in iconik it will also be removed from this storage when Purging
  12. Select Enable Scan if you wish to enable scanning for new files on this storage. A label "SCAN" will be visible next to the storage in the list. Click on SCAN to scan through the cloud storage and add the new files to iconik.
  13. If you only wish to scan a subset of the directories on this bucket, you can enter in Scan Directories which will limit the scanning to these directories only.
  14. Click to continue.

iconik will verify that is has access to the storage and report back if it finds that it doesn't have the necessary requirements or the credentials do not work.

Next steps

There are more parameters that can be configured, and these are detailed under: Editing S3 Compatible Storage

Learn more.