Installing ISG on Windows Installing ISG on Windows
  1. iconik
  2. iconik Storage Gateway (ISG) & Edge Transcoder
  3. iconik Storage Gateway (ISG)

Installing ISG on Windows

iconik Storage Gateway (ISG)

See all 19 articles

This section contains everything you need to know about installing and managing the iconik Storage Gateway (ISG) on Microsoft Windows.

ISG works on Windows 10, Windows 11, Windows Server 2016, 2019 and 2022

Installing the Transcoders

Local transcoding is required for viewing your content in the web browser

ISG comes packaged with FFmpeg and ImageMagick for local transcoding. For keyframe generation of PDF documents GhostScript is required, see installation instructions below.

Use of packaged transcoders can be controlled through the config.ini attributes:

use-packaged-imagemagick = true
use-packaged-ffmpeg = true

Using custom ffmpeg and imagemagick

Set above options to "false" if you need to use a specific version or a custom build of ffmpeg and/or imagemagick.

For local transcoding to work you will have to install ffmpeg, ghostscript and ImageMagick. BentOS and Exiftool are optional, but are recommended to install as well. Follow the instructions below to install the transcoders and add them to your system path.

  1. Download FFmpeg:
    • Go to FFmpeg official site.
    • Click on the Blue windows icon to see builds available for WindowsOS. (Gyan.dev is recommended to use)
    • Download the ffmpeg-git-full.7z (maybe a later version) zip file
    • Extract the downloaded zip file to C:\FFmpeg (or a preferred location).
  2. Download ImageMagick:
  3. Download GhostScript 
    • Go to GhostScript’s official site
    • Under GNU Affero General Public License select the option that matches your operating system
    • Open the .exe file that is downloaded to your machine
    • Go through the installation wizard
  4. Download Bento4
    • Go to Bento4’s official site
    • Select the Binaries for Windows option
    • Extract the downloaded zip file to C:\Bento4 (or a preferred location)
  5. Download Exiftool
    • Go to Exiftools official site
    • Select the Windows option that matches your operating system
    • Extract the downloaded zip file to C:\Exiftool (or a preferred location)
    • Open the folder and navigate to the application file called exiftool(-k). Rename this file to exiftool
  6. Open the Environment Variables Editor
    • Press Win + R, type sysdm.cpl, and hit Enter
    • Go to the Advanced tab → Click Environment Variables
    • Under System variables, select Path → Click Edit
    • Note: Make sure you select System Variables and not User Variables
  7. Check that ImageMagick and Ghostscript binaries (bin) are in the list
    • These should look something like this:
      1. C:\Program Files\gs\gs10.05.1\bin
      2. C:\Program Files\ImageMagick-7.1.1-Q16-HDRI
    • If you do not see them, go through the installation instructions again and verify the location of the installed folders. Proceed to Step 8.
  8. Add Transcoder Binaries to System Path:
    1. Using the locations that you extracted the zip files to, find the bin folders. Examples of locations are below, but note that the location may vary depending on where you extracted to:
      1. ffmpeg: C:\ffmpeg\ffmpeg-2025-05-07-git-1b643e3f65-full_build\bin
      2. Bento4: C:\Bento4\Bento4-SDK-1-6-0-641.x86_64-microsoft-win32\bin
      3. Exiftool: C:\exiftool\exiftool-13.29_64\
    2. If you weren’t able to find ImageMagick or Ghostscript in the list from step 7, navigate to the installation directory, and find the bin folders. Add those to the path
  9. Verify that the transcoders are in the system path
    • Open the terminal app and run the command below. The output should show the transcoder version. If you receive an error, double check that the binary is in the system path, not the user path.
      1. ffmpeg -version
      2. magick -version
      3. exiftool -ver
      4. mp4info  (bento4) 
      5. gswin64c -v or gswin32c -v (depending on your OS)

Download and install the Iconik Storage Gateway

Download the latest package and run it:

https://downloads.iconik.io/IconikStorageGateway-latest.msi

If you want the ISG to support transcoding, install software that is listed below in Local Transcoding

The iconik Storage Gateway install will install the ISG service and the Windows tray application. The first time it will automatically start the Setup Wizard.

  1. Run the installer.
  2. Read and accept the license agreement.
  3. Click Install to start.
  4. Click Finish
  5. The wizard will start and the first step will ask you to log in to iconik using the Web Interface. Once that is done and you have approved the application to your credentials, go back to the installer.
  6. Provide account credentials to run ISG Windows Service and press Next.
  7. Select “Setup new iconik Storage Gateway” and press Next
  8. Give it a name that makes it possible to identify it (Default is your computers name followed by ISG)
  9. Select the Local folder that you want to scan and press Next
  10. This will set the ISG up to use local transcoding and not keep the original files locally. If you want to use any other settings, please click “Advanced Settings..” and that will take you to the Storage configuration page.
  11. Toggle on the "Start ISG after setup" checkbox if you want to start ISG after you press Finish.
  12. When you are done with your advanced settings press Finish

The tray application is visible as an iconik icon in your tray on your Windows computer. From here you can access the menu by right-clicking on the icon. There are options to start and stop the ISG, Configure, Run the setup wizard again, show the service logs and Quit.

Working with networked drives

For network drives setup please refer to the help page "Networked drives on Windows".

 

If you have already installed the iconik Storage Gateway before needing to create the link, open the Admin Storage Page in iconik and change the mount point to the new page before restarting the iconik Storage Gateway

Learn more