ISG on Ubuntu 18.04 (bionic)
This section contains everything you need to know about installing and managing the iconik Storage Gateway (ISG)
Set up the Cantemo APT repository, and install the Iconik Storage Gateway package
sudo apt-get install wget gnupg sudo curl https://packages.iconik.io/deb/ubuntu/dists/bionic/iconik_package_repos_pub.asc | apt-key add - sudo echo "deb [trusted=yes] https://packages.iconik.io/deb/ubuntu ./bionic main" > /etc/apt/sources.list.d/iconik.list sudo apt-get update sudo apt-get install iconik-storage-gateway
It will be installed in
/opt/cantemo/iconik_storage_gateway where you will also find the config file called
config.ini to look like this (See Setting up how to get the correct values)
[main] app-id = 22f34c6e-268e-11e7-ac53-6c4008b85488 storage-id = 15fa3f68-7693-11e7-bf0c-02420a021013 iconik-url = https://app.iconik.io/ auth-token = eyJhbGciOiJIUzI1NiIsImlhdCI6MTUwMTU3NjAyNCwiZXhwIjoxNTAxNjE5MjI0fQ.eyJpZCI6IjMzMjFkMjIyLTc2OTMtMTFlNy1hN2EyLTAyNDIwYTAyMTAxYSJ9.sgag4OQb19J9qT1IAdKZYAqbpIoai7oW60Mahye7o8s sleep-time = 10 max-transcoding-jobs = 1 file-upload-parallel-uploads-num = 4 file-download-parallel-downloads-num = 4 log-filename = /var/log/cantemo/iconik_storage_gateway/default.log
After installation you can start service with:
sudo systemctl enable iconik-storage-gateway sudo systemctl start iconik-storage-gateway
To check status of the service use:
sudo systemctl status iconik-storage-gateway
For following the log file, you can use the following command:
sudo tail -f /var/log/cantemo/iconik_storage_gateway/default.log
You can run also run the systemd service from your custom user providing it to
/lib/systemd/system/iconik_storage_gateway.service with passing your own config and log files that are accessible for your custom user. Log file location can also be set in config.
[Service] User=john Group=john ExecStart=/usr/bin/iconik_storage_gateway --config=/home/john/iconik_storage_gateway/config.ini --log-filename=/home/john/iconik_storage_gateway/default.log
You will need to give your new user permissions to the database file and the log directory as well (If you didn't change the logs)
sudo chown -R john:john /var/cantemo/iconik_storage_gateway/ sudo chown -R john:john /var/log/cantemo/iconik_storage_gateway/
After adding your custom user you need to restart service.
sudo systemctl daemon-reload sudo systemctl restart iconik-storage-gateway
For local transcoding to work you will have to install ffmpeg, poppler and ImageMagick. Make sure they are in the path for the user running the service.
sudo apt-get install software-properties-common sudo add-apt-repository ppa:jonathonf/ffmpeg-4 sudo apt-get install ffmpeg imagemagick poppler-utils ghostscript ufraw
To get frame accurate playback in other browsers than Safari you also need mp4mux from Bento4
Unpack the correct package, and copy the
mp4mux binary to
Update the storage settings in Iconik to say
Local keyframes and
Local proxy and restart the service.