Install and Deploy on CAST Imaging Documentation

Choose a Deployment Model

Mon, 01 Jan 0001 00:00:00 +0000

CAST Imaging can be deployed in three ways. Choose the model that best fits your infrastructure and operating constraints.

Before you start


Who this is for	IT administrator planning a new installation
Role required	None (planning phase)
Prerequisites	None

Comparison

Model	Operating system	Best for
Windows installer	Windows Server	Single-server setups, teams already using Windows infrastructure
Docker (Linux or Windows)	Linux or Windows with Docker Desktop	Reproducible environments, easier upgrades, containerized infrastructure
Kubernetes	Any Kubernetes cluster	High-availability, scalable, enterprise-grade deployments

Windows installer

The Windows installer packages all CAST Imaging components into standard Windows executables. Installation is straightforward and does not require container knowledge.

Check Requirements

Mon, 01 Jan 0001 00:00:00 +0000

Check these requirements before you start the installation. An undersized environment causes performance problems that are difficult to diagnose later.

Before you start


Who this is for	IT administrator planning a new installation
Role required	None (planning phase)
Prerequisites	None

Hardware requirements

Hardware needs depend on the size of the applications you will analyze.

Application size	Objects (approx.)	RAM	CPU cores	Disk (Neo4j data)
Small (S)	< 50,000	16 GB	4	50 GB
Medium (M)	50,000–200,000	32 GB	8	100 GB
Large (L)	200,000–500,000	64 GB	16	250 GB
Extra large (XL)	500,000–1,000,000	128 GB	32	500 GB
XXL	> 1,000,000	256 GB+	64+	1 TB+

[TODO: Verify values and add separate rows for PostgreSQL disk]

Install on Windows

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Local administrator on the Windows server
Prerequisites	Requirements checked; installation media downloaded

Step 1: Install CAST Storage Service

CAST Storage Service is a pre-configured PostgreSQL package. Install it first because the other components need it.

[TODO: Download location, installer steps, default port 2284]

Step 2: Install AIP Core and AIP Node

AIP Core is the analysis engine. AIP Node is the communication layer between AIP Core and AIP Console.

Install with Docker

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Docker user with permission to run containers and manage volumes
Prerequisites	Docker Engine 24+ and Docker Compose v2 installed; requirements checked

Step 1: Download the Compose file

[TODO: Where to get the official docker-compose.yml, login to CAST registry if needed]

Step 2: Configure environment variables

Copy the example .env file and fill in the required values:

[TODO: List of required environment variables — database passwords, ports, volume paths, license key]

Install on Kubernetes

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	Platform engineer or Kubernetes administrator
Role required	Kubernetes cluster admin
Prerequisites	Kubernetes 1.25+; Helm 3; requirements checked; persistent storage class available

Step 1: Add the CAST Helm repository

[TODO: helm repo add command and repository URL]

Step 2: Create a values file

[TODO: List of required values — image registry, storage class, resource limits, ingress settings]

Step 3: Install the chart

helm install cast-imaging cast/imaging -f values.yaml -n cast-imaging --create-namespace

Step 4: Configure ingress

[TODO: Example ingress resource for the CAST Imaging web interface]

Configure HTTPS / TLS

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Local server admin (Windows) or Docker/Kubernetes admin
Prerequisites	CAST Imaging installed and running on HTTP; TLS certificate available (PEM format)

Windows installation

[TODO: Steps to configure Nginx (or the embedded web server) to use the TLS certificate; how to reconfigure the front-end service port to 443]

Docker installation

[TODO: Steps to mount the certificate into the Nginx container; update the Compose file to expose port 443]

Configure Authentication

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Super Admin
Prerequisites	CAST Imaging installed; LDAP server details or SSO provider details if applicable

Local accounts

By default, CAST Imaging uses local accounts managed in the Admin Center. No additional configuration is needed. Manage users in Manage users.

LDAP / Active Directory

LDAP authentication lets users log in with their existing corporate credentials.

[TODO: Configuration steps — LDAP host, port, bind DN, base DN, user filter, group filter]

Set Up the Source Code Viewer

Mon, 01 Jan 0001 00:00:00 +0000

The source code viewer displays the source file of any object directly in the canvas. It is an optional feature that requires access to the original source files.

Before you start


Who this is for	IT administrator
Role required	Super Admin
Prerequisites	CAST Imaging installed; source files accessible from the server

Step 1: Make source files accessible

The CAST Imaging server must be able to read the source files. Options:

Install an Offline Extension Server

Mon, 01 Jan 0001 00:00:00 +0000

CAST Imaging uses extensions (plugins) to support specific technologies. In a standard installation, extensions are downloaded from the CAST Extend cloud service. In air-gapped environments, you need a local server.

Before you start


Who this is for	IT administrator in an air-gapped environment
Role required	Local server admin
Prerequisites	A machine with internet access (for initial content download); a machine on the internal network to host the local server

Step 1: Install the CAST Extend local server

[TODO: Download and installation steps for the local server package]

Migrate from a Previous Version

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Super Admin; local server admin
Prerequisites	Existing v2.x installation; new server or environment for v3; backup of all data

Back up first

Always take a full backup before starting a migration. See Back up and restore.

Step 1: Export data from the v2.x instance

[TODO: Export Neo4j graph data; export PostgreSQL databases; note configuration file locations]

Step 2: Install CAST Imaging v3

Install v3 on the new server following the standard installation guide for your deployment model.

Upgrade an Existing Installation

Mon, 01 Jan 0001 00:00:00 +0000

Before you start


Who this is for	IT administrator
Role required	Local server admin (Windows) or Docker/Kubernetes admin
Prerequisites	Backup taken; release notes for the new version reviewed

Back up first

Always take a full backup before upgrading. See Back up and restore.

Windows installer

Use the ImagingSystemUpdate.exe tool to apply the update.

[TODO: Download location, command syntax, expected output]

Docker

Replace the container images with the new version tags.