1. Home
  2. iconik edge transcoder
  3. noble

Roles

These are the roles that are needed:

  • Admin

iconik Edge Transcoder on Ubuntu 24.04 (noble)

This section contains everything you need to know about installing and managing the iconik Edge Transcoder

1. Download and install the iconik Edge Transcoder

Set up the iconik APT repository, and install the iconik Edge Transcoder package

sudo apt-get install wget gnupg
sudo tee -a /etc/apt/sources.list.d/iconik.list >/dev/null << EOF
deb [signed-by=/usr/share/keyrings/iconik.gpg] https://packages.iconik.io/deb/ubuntu ./noble main
EOF
curl https://packages.iconik.io/deb/ubuntu/dists/noble/iconik_package_repos_pub.asc |\
sudo gpg --dearmor -o /usr/share/keyrings/iconik.gpg    
sudo apt-get update
sudo apt-get install iconik-edge-transcoder

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 ffmpeg imagemagick poppler-utils ghostscript dcraw libimage-exiftool-perl

For ffmpeg you can alternatively download a static build which doesn't require any additional libraries. This is available from https://johnvansickle.com/ffmpeg/. Note that the static ffmpeg builds may require running nscd to avoid problems with DNS resolution:

sudo apt-get install nscd

We recommend you consult the build READMEs for further information.

To get frame accurate playback in other browsers than Safari you also need mp4mux from Bento4

https://www.bento4.com/downloads/

Unpack the correct package, and copy the mp4mux binary to /usr/local/bin

To write xmp metadata which can be used in our adobe integration to the proxy files you need Exiftool

sudo apt-get install exiftool

2. Edit config.ini

Edit /etc/iconik/iconik_edge_transcoder/config.ini to look like this (See Setting up how to get the correct values)

[main]

app-id = 22f34c6e-268e-11e7-ac53-6c4008b85488
iconik-url = https://app.iconik.io/
auth-token = eyJhbGciOiJIUzI1NiIsImlhdCI6MTUwMTU3NjAyNCwiZXhwIjoxNTAxNjE5MjI0fQ.eyJpZCI6IjMzMjFkMjIyLTc2OTMtMTFlNy1hN2EyLTAyNDIwYTAyMTAxYSJ9.sgag4OQb19J9qT1IAdKZYAqbpIoai7oW60Mahye7o8s
sleep-time = 10
max-transcoding-jobs = 4
log-filename = /var/log/iconik/iconik_edge_transcoder/default.log
use-file-cache-proxy = true
session-timeout = 60
image-magick-config = /etc/iconik/iconik_edge_transcoder/image_magick_config

3. Start caching proxy service (Optional)

Using the caching proxy can significantly increase performance in some transcoding scenarios. To use it the service must be running.

sudo systemctl enable iconik-file-cache
sudo systemctl start iconik-file-cache

Make sure the setting is enabled in config.ini, see Advanced options

4. Start the service

After installation you can start service with:

sudo systemctl enable iconik-edge-transcoder
sudo systemctl start iconik-edge-transcoder

This will create the Transcoder in iconik the first time you start it. You have to add this transcoder to the corresponding storages in the iconik UI for it to work.

Add the Transcoder's id to the configuration file as transcoder-id attribute. You find this in the URL when you are editing the transcoder in the format 6f9c5e54-fb9f-11e7-8152-0a580a000240 or in the transcoder list as a button you can click to copy.

To check status of the service use:

sudo systemctl status iconik-edge-transcoder

For following the log file, you can use the following command:

sudo tail -f /var/log/iconik/iconik_edge_transcoder/default.log

You can run also run the systemd service from your custom user by providing an override (sudo systemctl edit iconik-edge-transcoder.service) 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=
ExecStart=/usr/bin/iconik_edge_transcoder --config=/home/john/iconik_edge_transcoder/config.ini --log-filename=/home/john/iconik_edge_transcoder/default.log

After adding your custom user you need to restart service.

sudo systemctl daemon-reload
sudo systemctl restart iconik-edge-transcoder

Installation guides per platform:

More information for Administrators