Main installation page from Iconik:  https://help.iconik.backlight.co/hc/en-us/articles/25304304628503-Installing-ISG-on-Ubuntu-22-04#prerequisites


1. Prepare the OS

sudo apt update && sudo apt upgrade -y

2. Install all packages for transcoding, image and document processing.

sudo apt install -y ffmpeg bento4 imagemagick poppler-utils dcraw ghostscript exiftool mediainfo


3. Prepare the Storage Directories locally on your storage

Create the original, proxy and keyframe directories.

sudo mkdir -p /mnt/iconik/originals /mnt/iconik/proxies /mnt/iconik/keyframes
sudo chown -R iconik:iconik /mnt/iconik/

4. Obtain your Iconik API credentials.

    a.  Log into Icoonik as your Admin user.

    b. Go to  Admin -> Settings -> Application Tokens

    c. Create a new Application

5. Get the  User Token and ID from this page and paste them into a document for later use.

6. Add the Iconik Repository and Install ISG

curl -s https://packages.iconik.io/iconik.gpg | sudo gpg --dearmor -o /usr/share/keyrings/iconik.gpg
echo "deb [signed-by=/usr/share/keyrings/iconik.gpg] https://packages.iconik.io/apt/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/iconik.list
sudo apt update
sudo apt install -y iconik-storage-gateway

7. Run the setup wizard

sudo iconik_storage_gateway setup

Enter in your API URL : https://app.iconic.io )

Enter in your Client ID and Client Secret  ( from step 5 )


8. Edit the /ect/iconik/iconik_storage_gateway/config.ini as needed:

[storage]
path = /mnt/iconik/originals
transcoder = local

[transcoder]
enabled = true
proxy_output_path = /mnt/iconik/proxies
keyframe_output_path = /mnt/iconik/keyframes


9. Start and Enable the ISG

sudo systemctl enable iconik-storage-gateway
sudo systemctl start iconik-storage-gateway
sudo systemctl status iconik-storage-gateway

10. Add Transcoders

       a. Go to the ADMIN -> Transcoders

       b. + NEW TRANSCODER

       c. Give a name. ( Best to keep in a naming convention )

               Iconik Storage Gateway Image Transcoder

               Iconik Storage Gateway Video Transcoder

       d. Keep Cloud transcoder  ' OFF '

       e. Transcoder type -

               Video = iconik: The built-in video transcoder in iconik   ( which is ffmpeg )

               Image = Imagemagik: The built-in image transcoder in iconik  ( which is imagemagik )



11. Add the Transcoders to your storage.

       a. Go to the ADMIN -> Storages

       b. Click on the " Transcode settings " Tab.

       c. Click on " ADD "

       d. Select the 2 new transcoders you just created.



12. Restart the ISG services.

sudo systemctl restart iconik-storage-gateway

13. Test by putting files in the originals folder you created earlier.

14. You can view the log

tail -f /var/log/iconik/iconik_storage_gateway/default.log