install-senzing-using-docker.md

HOWTO - Install Senzing using Docker

Build Docker Senzing installer

Perform once per new Senzing version:

1. To use the Senzing code, you must agree to the End User License Agreement (EULA).

   ⚠️ This step is intentionally tricky and not simply copy/paste. This ensures that you make a conscious effort to accept the EULA. Example:

   export SENZING_ACCEPT_EULA="<the value from this link>"

2. Build a Docker image which will be used to install Senzing. Example:

   curl -X GET \
       --output /tmp/senzing-versions-latest.sh \
       https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-latest.sh
   
   source /tmp/senzing-versions-latest.sh
   
   sudo docker build \
     --build-arg SENZING_ACCEPT_EULA=${SENZING_ACCEPT_EULA} \
     --build-arg SENZING_APT_INSTALL_PACKAGE=senzingapi=${SENZING_VERSION_SENZINGAPI_BUILD} \
     --build-arg SENZING_DATA_VERSION=${SENZING_VERSION_SENZINGDATA} \
     --no-cache \
     --tag senzing/installer:${SENZING_VERSION_SENZINGAPI} \
     https://github.com/senzing-garage/docker-installer.git#main

Install Senzing using Docker container

1. ✏️ Identify location to install Senzing. Example:

   export SENZING_VOLUME=~/my-senzing
   mkdir -p ${SENZING_VOLUME}

2. Install Senzing using locally-built Docker container. ${SENZING_VOLUME} is the installation location and may be changed. Example:

   curl -X GET \
       --output /tmp/senzing-versions-latest.sh \
       https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-latest.sh
   source /tmp/senzing-versions-latest.sh
   
   sudo docker run \
       --rm \
       --user 0 \
       --volume ${SENZING_VOLUME}:/opt/senzing \
       senzing/installer:${SENZING_VERSION_SENZINGAPI}