Overview

Architecture

The services a ScanSuite installation runs, and the deployment models.

View as Markdown

What a ScanSuite Teams installation runs and how it can be deployed. Three deployment models exist: a single server, which runs every scan type, and Google Cloud or Azure, which run the static analyses on managed services. Where a server keeps its data and which network flows it needs are in Administration.

On a server

ScanSuite single-server deployment diagram
A single-server deployment: the ScanSuite services and the scanner containers on one host, reaching the AI provider, external scanners and a co-located DefectDojo over HTTPS

The installer puts everything in /opt/scansuite and runs it with Docker Compose. Every service is a container; ./scansuite status lists them and ./scansuite logs <service> shows the log of one. The web, worker and scheduler containers restart by themselves after a crash.

Capacity

Each scan worker runs one scan at a time, so a default installation runs two scans in parallel and queues the rest. ./scansuite restart <n> starts n workers (1 to 100); size the host for them as Technical Requirements describes. The count applies until the next start without one: the boot service starts two again after a reboot.

On Google Cloud

The console and workers run on Cloud Run (or GKE, with platform = "gke"), with Cloud SQL for PostgreSQL, Memorystore for Redis, Cloud Storage for scan artefacts, Secret Manager for passwords and Artifact Registry for the images. Each scan runs as its own Cloud Run job. There is no Docker daemon, so this deployment runs the static analyses; Vertex AI or any OpenAI-compatible endpoint is the AI provider.

ScanSuite on Google Cloud deployment architecture diagram
ScanSuite on Google Cloud: the console and scan workers on Cloud Run inside a project VPC, backed by Cloud SQL, Memorystore, Cloud Storage, Secret Manager and Artifact Registry, reaching Vertex AI and external scanners over HTTPS

What gets built, and how to deploy it: Install on Google Cloud.

On Microsoft Azure

The console and workers run on Azure Container Apps, with Azure Database for PostgreSQL, Blob Storage, Key Vault and the deployment's own Container Registry, all in one resource group. Each scan runs as its own Container Apps job. As on Google Cloud, this deployment runs the static analyses; Azure OpenAI or any other OpenAI-compatible endpoint is the AI provider.

ScanSuite on Microsoft Azure deployment architecture diagram
ScanSuite on Microsoft Azure: the console and scan workers on Azure Container Apps inside a resource group and virtual network, backed by PostgreSQL Flexible Server, Redis, Blob Storage, Key Vault and Container Registry, reaching Azure OpenAI and external scanners over HTTPS

What gets built, and how to deploy it: Install on Microsoft Azure.

Which one to choose

DeploymentScansWhat you look afterHow
A serverEvery scan type: code, dependencies, secrets, web applications and APIs, infrastructure, AI pentest.You run the server: OS updates, disk, backups.Install ScanSuite Teams
Google CloudStatic analyses: code, dependencies, infrastructure as code, secrets.Managed services; you run Terraform.Install on Google Cloud
Microsoft AzureStatic analyses: code, dependencies, infrastructure as code, secrets.Managed services; you run Terraform.Install on Microsoft Azure

Last reviewed 2026-10-19