Install a Groundplex on Docker

Steps to install a Groundplex on Docker

SnapLogic support for the Groundplex on a Docker container empowers you to optimize IT infrastructure costs while benefiting from containerized technology. Our latest Docker image is built on AlmaLinux, ensuring compatibility and reliability. To access the most recent Docker image, simply execute a pull operation from our Docker Hub repository as suggested in the installation steps below.

Updating the Docker image also updates the Java Runtime Environment (JRE) bundled inside it — you don't install or manage a JRE separately for a Docker-based Snaplex. For example, the Docker image update to version 4.39 GA updated the bundled JDK from 11.0.17 to 11.0.24; this update did not affect any existing pipelines.

Important: Starting with JDK 11.0.10, the bundled JRE disables TLS 1.0 and 1.1 by default for outbound connections — that is, connections your pipelines make to external systems such as databases or APIs. If a pipeline connects to an external system that only supports TLS 1.0 or 1.1, that connection stops working after this update; the fix is to upgrade the external system to support TLS 1.2 or higher. This is separate from the SnapLogic Platform's own requirement that inbound requests to it use TLS 1.2, which this update doesn't change. See Inbound and outbound communication for the Platform's TLS requirements.

Install Groundplex in a Docker container

  1. Find the build number for the Snaplex version you want to install, using either of the following:

    • The Version dropdown in Admin Manager's Snaplex Create or Update page. Cross-reference the build number against Snaplex version by release if needed.
    • The Tags tab of the snaplogic/snaplex repository on Docker Hub.
    Note: Copy only the numeric build number itself, for example 22564. Don't copy a full version label such as main-22564 - 4.36 GA — the main- prefix is already part of the command below, and the text after the build number isn't part of the tag at all.
  2. Retrieve the Docker image for that build from Docker Hub using the following pull command, replacing build number with the value you found in the previous step: 
    docker pull snaplogic/snaplex:main-build number
  3. In Admin Manager, navigate to Snaplexes screen to view pages listing the Snaplexes and select the Groundplex instance to display the Update screen.
  4. In the Downloads tab, click Download icon in the Configuration option to download the slpropz file for your Groundplex node.
    Configuration file

  5. After downloading the configuration file, you are ready to launch your Groundplex as a Docker container.

Download tab

Important: Depending on how you install Docker, you may need to use sudo. For more information on the Docker run command, refer to Docker Run.