Skip to main content

Jama Connect Help

Remove old Docker images

Old Docker images from previous versions of Jama Connect use up storage space and might cause indexing to fail. To avoid this, periodically remove old Docker images from your system to keep it running smoothly.

You can also remove dangling volumes, which are volumes associated with a container that no longer exists. Jama Connect creates new containers and volumes when you restart the application. These volumes can fill up your disk space.

Important

Make sure Jama Connect is running so that you delete only images that are not in use. The commands in this task clean only images and volumes loaded with the Docker storage driver in use. Files that were written with other storage drivers remain on the volume until separate commands are run for that storage driver.

To clean up your volumes:

  1. Identify how much space is being used on your server:

    sudo docker system df
  2. List out all Docker images on your server:

    sudo docker images

    Images are displayed on the screen, listed by their ID in the IMAGE ID column.

    docker_image_id.png
  3. Remove an image by its ID:

    sudo docker rmi IMAGE_ID
  4. Identify the dangling volumes:

    docker volume ls -qf dangling=true
  5. Remove any dangling volumes from the Docker data root directory:

    docker volume rm $(docker volume ls -qf dangling=true)

The specified images are removed.

Note

When you run these commands to remove an image that is currently in use, an error is displayed. For self-hosted customers with internet access, any missing images are downloaded again when you restart Jama Connect. For airgap customers, you must manually load the images.