Skip to main content
sramanujam
Staff
Staff
January 1, 2026

Troubleshooting Tip: How to resolve the SSH Connector (v2.1.2) Dependency Issues

  • January 1, 2026
  • 0 replies
  • 102 views

 

Description

This article describes how to fix the error 'Error on health check of the connector ssh version 2.1.2: No module named 'voluptuous''.

2025-12-30 23_09_28-image (3) (9).png

This issue occurs when the required Python dependency, voluptuous, is missing in the SSH connector virtual environment.

Scope FortiSOAR v7.5.x, v7.6.x, SSH Connector v2.1.2.
Solution

Step 1: Check whether the specified module is available in the environment using the command below.

 

# /opt/cyops-integrations/.env/bin/pip freeze | grep voluptuous

 

Step 2: If the module is not listed, it must be reinstalled. For SSH connector version 2.1.2, install the required voluptuous version 0.15.0. Reinstall the module using the commands below.

 

# /opt/cyops-integrations/.env/bin/pip install voluptuous==0.15.0

 

Step 3: Verify the installation and rerun the SSH connector health check.

 

# /opt/cyops-integrations/.env/bin/pip freeze | grep voluptuous

 

Note: It is always recommended to take a snapshot of the VM before performing any changes on the system.