Jama Connect User Guide

Configure general properties
  1. Log in as root user.

  2. To modify general properties, select the System properties tab in the administrative window, then select Edit in the top, right corner.

  3. Make your changes to any of the following:

    • Session timeout

      This automatically disconnects idle users after a set time. The default is 120 minutes. When a session times out, the user sees a pop-up window prompting them to log in. This setting is useful when using floating licenses because it releases licenses from idle users.

    • Enable HTML tag security cleaning

      This prevents any suspicious HTML tags from being added to new and modified rich text fields and test steps. However, it will not clean up data retroactively. It is enabled by default.

    • SMTP settings

      These settings affect notifications and subscriptions.

      • SMTP Enabled: Select Yes to use SMTP

      • SMTP Host: The domain address of your SMTP server

      • SMTP Port: The port for SMTP access

      • SMTP User: User account to access SMTP 

      • SMTP Password: Password for the user account 

      • Authorization Required: Select Yes if authorization is required for the SMTP server 

      • Use TLS: Select Yes if your mail server uses TLS

    • Collaboration from Address/IMAP


      Check with your administrator whether your e-mail server supports IMAP. IMAP must be supported to enable reply-to e-mails in the stream.

      • System "From" address: Enter an address for the system to use when it sends email notifications or other system messages. For example: info@mycompany.com.

      • Collaboration "From" address: This should match the email address used for IMAP, so that replies to stream emails will be sent to the same account that is setup to process the incoming mail. For example: replyto@mycompany.com.

      • IMAP enabled: Select Yes to use IMAP and stream emails.

      • IMAP server: Enter the domain address of your email server (for example, imap.gmail.com).

      • IMAP port: The port for IMAP access, typically differs from SMTP. Standard ports are Non-SSL:143, SSL:993.

      • IMAP use SSL: Select Yes to use SSL.

      • IMAP user account: Enter a user account for someone who has access to the folder where IMAP emails are saved.

      • IMAP user password: Enter the password for the user account.

      • IMAP folder: Folder where collaboration emails are sent or saved. For example: Inbox. Messages are regularly sent to this folder, so it must be accessible by the person with the IMAP user account.

      • IMAP error folder: Folder where IMAP collects parsing issues or errors.

    • Time and date formatting

      Set the time to meet the needs of your users.


      Java and JavaScript do not use the same date-time syntax. Please review the difference prior to setting the values.

      For example, here are some typical time formats:




      m/d/Y h:i a



      MM/dd/yyyy hh:mm:ss a z



      If your users are using Windows, be sure that "Adjust for daylight saving time automatically" is enabled in "Date and time" settings in Windows, so that the time zone displays correctly in reviews.


      The Trace View date format is inherited from a different format than other items in the application. In order to match formats, you must have the Javascript Day/Month/Year format and Javascript Date/Time format in the same order. This is most notable when using a European date format.

    • Allow project administrators to add groups

      Select Yes for project administrators to add groups. Otherwise, only system and organization administrators can add groups.

    • Allow project administrators to set project permissions

      Select Yes for project administrators to grant project permissions. Otherwise, only system and organization administrators can grant permissions.

    • Allow access to REST API

      Enable this so that users can perform actions in Jama Connect from outside of the user interface.

    • Attachment file extensions

      When users upload attachments or images to the rich text editor, this creates an attachment in the application.

      This list limits the file types that can be uploaded by users as an attachment.

      Enter the allowed file extensions as a list, separated by commas, periods, spaces or newline characters.


      Files will be rejected if the contents of the file do not match the file extension, or if the MIME type is not understood by the system, even if the file type is listed here. You can override this so that files of an unknown type are allowed by setting the option to a blank string.


      File extensions need to be lowercase even if the actual extension on the file is uppercase. Learn more.

    • Notice on login page

      This is a way for system administrators to provide a notice to users. Enter the desired message (HTML formatting can be used) and it will appear below the login window. It will also appear in a yellow bar at the base of the application window.

      Jama Connect login page with a message at the bottom that says "You can add a custom message that appears here".


      This login page may not be visible if you are using SSO or SAML logins.

    • Maintenance mode

      Enable this feature to log out all users except the root user. All users, except root, remain locked out until this is disabled.


      While reindexing, Jama Connect automatically goes into maintenance mode and locks out users until indexing is complete. As root user, you can manually disengage maintenance mode here, but it is not recommended. Maintenance mode will automatically turn off when the reindex is completed.

    • Set header color

      This helps to easily differentiate test or staging instances from the production instance of Jama Connect.

  4. Select Save.