Install a Docker-based connector

How to set up an EAA connector as a Docker image on a Docker-ready environment. Client-Access applications cannot be attached to a Docker-based connector.

Before you begin

Verify Docker is properly installed. Enterprise Application Access (EAA) connectors installed as Docker containers require a Docker-ready OS environment. If you do not have Docker installed, see the instructions at for your environment.

How to

  1. Create and download a connector in EAA.
  2. In your Docker environment, open a terminal window.
  3. Navigate to the downloaded Docker container.
  4. Unzip the Docker image:
    $ gunzip <Connector_docker_image_filename.tar.gz>
  5. Load the image into Docker:
    $ sudo docker load -i <Connector_docker_image_filename.tar>
  6. Check that the image is loaded properly and find the <docker_image_name>:
    $ sudo docker images
  7. Run the Docker image:
    $ sudo docker run --name <Connector_Name> --restart=always -d <docker_image_name>
  8. Confirm that the Docker-based container is running:
    $ sudo docker ps
  9. Return to the EAA Management Portal and verify that the connector shows the private and public IP addresses assigned to it.
  10. Click Click here to approve the connector.
  11. Wait while the EAA service verifies the connector. A success message appears when the Docker-based connector is running as a container.
  12. To prevent abnormal behavior in the event of the agent being restarted, commit the connector to a new image:
    $ sudo docker commit <Connector_Container_ID> <new_image_name>

    Replace <new_image_name> with any name you choose for this connector.

What you should see

Your Docker-based connector now runs as a container on your server, and you can add your applications and secure them with EAA.