Skip to main content

Jama Connect Interchange User Guide

Install Jama Connect Interchange (self-hosted)

Jama Software sends you an email that includes the installation package. Complete these steps to install Jama Connect Interchange on your host server.

To install Jama Connect Interchange:

  1. Install the Docker engine on the JCI host server following Docker's instrurctions: https://docs.docker.com/engine/install/

  2. Open the email from Jama Software, download the installation package, and copy it to the host system.

  3. On the host system, create the application directory for Jama Connect Interchange:

    sudo mkdir /opt/jci  

  4. Untar the archive of docker images to the target directory:

    sudo tar -xf jci-self-host-{VERSION_TAG}.tar.gz -C /opt/jci/  

    The archive includes an additional tarball and a Docker compose file.

  5. Load the images into the system registry from the tarball:

    sudo docker load < /opt/jci/jci-self-host-{VERSION_TAG}.tar  

  6. Run Docker compose to start the services:

    cd /opt/jci sudo docker compose up -d  

  7. Test the web service:

    curl http://localhost:8080/login  

    By default, the application is available at localhost:8080. The curl command returns you to the login page.

  8. Update the hostname to make the web service externally accessible:

    sudo docker exec -i config-svc-interchange sh -c "../update_host_url.sh 'http://{SERVER_HOST}:8080/'" 

The Jama Connect Interchange services are restarted.

In this section: