What software do I need?

OS

  • Microsoft Windows 10/11 64bit
  • Microsoft Windows Server 2016/2019/2022 64bit (Server Core is not supported)

Java

  • Java JDK (≥ 17 LTS and ≤ 20 64bit), with appropriate %JAVA_HOME% system environment variable. Most Java variants certified by the OpenJDK Community Technology Compatibility Kit are compatible (you can verify if a company has access to the TCK on the OpenJDK website external link).

curl

  • curl external link is required by the installer (on each machine where the installer is executed) to run service health checks during the installation process. You can check if curl is already installed by running curl --version in a CMD window (most releases of Microsoft Windows already have curl installed by default). If curl is not installed you can download it from https://curl.se/windows/ external link.

Local user permissions - intallation

  • Local administrator privileges (ability to Run as administrator on Microsoft Windows)
  • The ability to execute Powershell scripts is required during the installation process on Microsoft Windows machines
  • The user account running a CAST Imaging installation requires Full Control permissions (either directly or as a member of a group) on the root folder where CAST Imaging components will be installed, i.e. if using the default locations:
    • %PROGRAMFILES%\CAST\
    • %PROGRAMDATA%\CAST\

Full Control

Local user permissions - Microsoft Windows Services

  • The default user assigned to all CAST Imaging Microsoft Windows Services during the installation is LocalSystem: CAST highly recommends that this user is not used to run these Windows Services on a permanent basis. This is particularly true if you need to use a proxy service to access specific resources such as CAST Extend and when using shared network services for data storage for deploy/delivery/common-data folders (see here). In this situation, the user running the Microsoft Windows Service will be used to access the proxy/shared network services. Instead, CAST recommends using the login credentials that match the user account used to install CAST Imaging - for example, this could be a specific “service account” that is created specifically for installing and running CAST Imaging. This service account would also therefore require access to the shared network resources and would need to be granted permission to use the system proxy settings. See the variables START_AS_USER, ...START_AS_USER, START_AS_PASSWORD, ...START_AS_PASSWORD for more information about changing these during the installation.

  • The user account (“service account”) assigned to the Microsoft Windows Services requires Full Control permissions (either directly or as a member of a group) on the following folder if using the default locations:

    • %PROGRAMFILES%\CAST\
    • %PROGRAMDATA%\CAST\
    • %APPDATA%\CAST\
    • Shared network location for common-data/delivery/deploy.

CAST Extend

Licensing

  • A valid global CAST Imaging license key (provided by your CAST sales contact), either:
    • a CD license (Contibuting Developers)
    • a Named Application license

Browsers for end user access

Browser Minimum supported release
Microsoft Edge 44 and above
Mozilla Firefox 95 and above
Google Chrome most recent only
Safari 12 and above

OS

  • Linux 64bit (x64 only with glibc ≥ 2.28 (use ldd --version to view your current release)) - recent releases of derivatives of RHEL / Debian recommended:
    • RHEL-compatible distributions: RHEL 8, RHEL 9, Rocky Linux 8, Rocky Linux 9
    • Debian-compatible distributions: Debian 11, Debian 12, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS
    • Not compatible with: ARM64/AArch64 variants

Docker

  • Docker Engine ≥ 20.10 (must be installed on the host machine)
  • Docker Compose, latest stable release embedded in Docker Engine recommended (or at least ≥ 2.x). Older installations of Docker Compose 1.x that require the docker-compose command (with hyphen) are not compatible. CAST installation scripts use the docker compose command (without hyphen).
  • Access to https://hub.docker.com/ external link on port 443 via TCP.

Containerization via Docker is only supported when using an installation of Linux installed direct on a physical or virtual machine, i.e. the use of WSL (Windows Subsystem for Linux) 1 or 2 on a Microsoft Windows machine, or using Docker Desktop is not supported.

Local user permissions

  • User in the sudoers list.

/tmp folder

The installer requires the use of the /tmp folder during the installation process. If you have mounted this folder to another location, you must ensure it is mounted with exec permissions. If /tmp is mounted with noexec for security reasons, you may encounter the following error during installation:

error while loading shared libraries: libz.so.1: failed to map segment from shared object

To verify whether exec permissions are granted to /tmp, run:

mount | grep /tmp

This command displays the mount line for /tmp along with its options. If noexec appears in the output, executables cannot run from /tmp and you’ll need to temporarily change the mount options to allow execution:

# Remount /tmp with exec permissions before running the installer (these changes will not persiste through a reboot)
sudo mount -o remount,exec /tmp

# Run your installer here

# Remount /tmp with noexec when installation is complete (for security)
sudo mount -o remount,noexec /tmp

CAST Extend

Licensing

  • A valid global CAST Imaging license key (provided by your CAST sales contact), either:
    • a CD license (Contibuting Developers)
    • a Named Application license

Browsers for end user access

Browser Minimum supported release
Microsoft Edge 44 and above
Mozilla Firefox 95 and above
Google Chrome most recent only
Safari 12 and above