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