Overview of the tenant manager

Author: Savya Bandari

Date: November 12, 2025

Audience: Everyone

Environmental details:

• Self-hosted, Replicated - KOTS

Summary

This article details the purpose, functionality, and importance of the tenant-manager role in overseeing tenant operations within the Jama Software environment.

The primary role of the tenant manager is to automate the preparation, creation, and upgrade of tenants within the KOTS environment.

How it works

• The job is initiated as part of the deployment or upgrade process..
• It communicates with the application’s API to verify and update the tenant’s state.
• Once its tasks are complete, the tenant-manager job terminates itself.
• When is Tenant-Manager Used?

  • During the creation of a new tenant in KOTS

  • When upgrading an existing tenant (e.g., during application upgrades)

  • When preparing tenant environments for configuration changes

Additional Information/Metadata

The tenant-manager is an essential service for overseeing tenant lifecycle events in Jama's KOTS deployments. If there are issues with tenant creation or upgrades, review the status of the tenant-manager job and redeploy it if needed. For ongoing issues, refer to the logs or contact Jama support for assistance. you experience 

Additional Resources

• Jama Connect Issue After License Change. Message: "Tenant "jama" has not been initialized.
• How to reset the tenant state

Feedback:
Have suggestions or improvements? Please leave your feedback in the comments section below.