These are the roles that are needed:

  • Admin

ISG Advanced Options (And Edge Transcoder)

The iconik Storage Gateway has a number of advanced options that you can tune by editing the configuration file config.ini. Most of these options also apply to the iconik Edge Transcoder, except the ones related to scanning

  • Back up config.ini before you make these changes.
  • Configuration options are key value pairs such as proxy-resolution=1920x1080
  • Configuration options should be on individual lines.
  • Restart the ISG after making the changes

config.ini location

OS Location
Linux /opt/cantemo/iconik_storage_gateway/config.ini
Windows C:\Program Files\Cantemo\Iconik Storage Gateway\config.ini
MacOS /Library/Application Support/Cantemo/IconikStorageGateway/config.ini

Please make sure if you are editing on Windows the line endings are of a Unix type

Setting Proxy Format Specification

It's possible to change the proxy format that the ISG will generate for video media. Please note that setting the bitrate too high or low can have a negative impact on the perceived performance of the Web Interface.

Proxy resolution:

By setting the key proxy-resolution you can define the max-dimensions of the proxy created.

  • Minimum value: 640x360
  • Default value: 1280x720
  • Maximum value: 1920x1080

For example:


Proxy bitrate

By setting the key proxy-bitrate you can define the max bitrate of the proxy created. Please be aware that setting this higher can cause large file sizes for your proxy.

  • Minimum value: 200000
  • Default value: 3000000
  • Maximum value: 10000000

For example:


Controlling file transfers and transcodes

Number of parallel uploads and downloads

By setting the key file-upload-parallel-uploads-num you can control how many simultaneous uploads the ISG will do. The default is 4 By setting the key file-upload-parallel-uploads-threads-num you can control how many parallel chunks for each upload is used. The default is 5

file-upload-parallel-uploads-num = 4

file-upload-parallel-uploads-threads-num = 5

By setting the key file-upload-parallel-downloads-num you can control how many simultaneous downloads the ISG will do. The default is 4

file-download-parallel-downloads-num = 4

Number of parallel transcodes

By setting the key max-transcoding-jobs you can control the number of simultaneous local transcodes.

max-transcoding-jobs = 2

This should be roughly the number of processing cores of your machine divided by 4. So if you 8 cores in your processor, the number should be 2.

Enabling debug

Debug is enabled by setting the option debug to true

debug = true

Mediainfo timeouts

If you get timeouts reading media info you can increase that, the default is 60s

extract-mediainfo-timeout = 180

Control the number of checksum workers

Checksumming is both CPU and I/O intense. You can control the number of parallel workers doing checksumming. The default is the number of CPUs on your server

checksum-max-workers = 4

You can also enable and disable it (but it is required for "Consider identical files the same")

enable-checksum-calculation = true

Disable the UUID-suffix on uploaded files

By default the ISG will add a UUID to the end of the file name when uploading to a cloud storage to make sure it does not conflict with any existing files. This can be disabled if you know that only this ISG will write to that cloud storage.

auto-generate-filename-for-remote-upload = false

Overriding format detection

Some times you might have files that gets identified as the wrong type. You can override this by file extension by providing a list:




This means that regardless of what mediainfo returns they will be sent to the transcoder that handles the type of format you have specified.

Some formats require to flatten layers, this list can be modified.,.tif,.tiff,.png,.psd,.pdf,.psb,.gif,.eps

For Edge transcoder some formats also require downloads, since they can't be read over https.


Overriding proxy and keyframe storage

You can override the proxy and keyframe storage used for an ISG by putting the follwing in the config.ini file:



ImageMagick Custom Path

If you have installed ImageMagick outside of the system path it can be useful to specify a path to imageMagick configuration files:

image-magick-config = /custom/path

This path should be where policy.xml, delegates.xml etc. is located

Apply custom RGB conversion profiles (ICC)

If you have for example TIFF files in CMYK that requires a specific ICC to convert to RGB, you can specify that. You can specify any number of icc files in order separated by semicolon. Note that the value is a comma separated list of extension=path1;path2


WAL mode

WAL can improve performance on large ISG installation. It is controlled by this setting.

sqlite-journal-mode = wal

To turn it off set

sqlite-journal-mode = delete

Video encoder

You can change the default h.264 encoder. For example on Apple silicon you can try this for better performance. Note that this also requires you to set the resolution and bitrate on the attached transcoder to get decent quality


Learn More