Installing the Image service on Linux

You can install the Image service either on the same computer or on a different computer from where Cognos Analytics is installed.

The Image service supports Linux and Windows 10 platforms and requires Docker to be installed.

Note: Docker CE (Community Edition), Docker Engine, and Docker Desktop (CE) are supported at this time.

Before you begin

Install Docker or Podman on Linux before you install the Image service.

For more information, follow the procedures for one of these Linux distributions:

For Docker:

For Podman:

  • Install podman 4.1.1 or later
  • Install podman-compose 1.0.4 or later
  • Install and configure netavark container network stack

You must set the fully qualified domain in Cognos Configuration using the following procedure:

  1. In IBM Cognos Configuration, in the Explorer window, click Environment.
  2. Under the Dispatcher URI for external applications set the fully qualified domain name (FQDN) for the IBM Cognos Analytics server.
  3. Under the Gateway URI set the fully qualified domain name (FQDN) for the IBM Cognos Analytics server.
  4. Click File > Save.
  5. Restart the Cognos Analytics service.


  1. Download the IBM® Cognos® Analytics Server installer (11.2.4 and above) and Server repository from Passport Advantage.
  2. Double click the installer file.
  3. Follow the directions in the installation wizard to copy and install the files to your computer.
    The folder cognos_installation_location/image-service contains two subfolders:
    • image-service/images
    • image-service/scripts
      Tip: The folder image-service/scripts/unix contains all the scripts that you need to run.


      Purpose Run this to rebuild the images.
      config.conf Edit this configuration file to change the Image service parameters. Run this to load and start the Docker containers. Run this to remove old Docker images. Run this to start the Image service. Run this to stop the Image service. Run this to uninstall the Image service.
  4. Ensure that you have execute permissions for each script:

    Type chmod -R u+x image-service/scripts/unix

  5. Navigate to the image-service/scripts/unix directory.
  6. Type ./

    The install script runs.


All of the Image service Docker images are loaded from thecognos_installation_location/image-service/images directory and the Docker containers are started.

What to do next

After installing IBM Cognos Analytics and the Image service, you can configure the Image service.