# Configuring a custom Docker image on a node with no internet access

If your node manager does not have external access to the internet, then you can create a Docker image on an internet-enabled computer, and then transfer it to your node manager.

## About this task

Perform the first three steps of this task from the command line on a computer with internet access. Perform the rest of the task from the command line on the computer where your node manager is installed.

## Before you begin

- If you are using the script to build the base Docker image, you must have a connection to the internet. (A connection to the internet is not required if you are using a locally-available Docker image.)
- You must have a Linux computer where the node manager is installed. (Your node manager and the Spotfire Server are usually on different computers).
- You must have Docker installed on the computer running the node manager. If you install and start the service before you install Docker, then exceptions are written to the log.

Custom docker images for the service must contain the following.

- The Eclipse Temurin 21 Java Runtime.
- The JAVA_HOME environmental variable, correctly defined.

      ENV JAVA_HOME=</correct/path/to/java>

## Procedure

1. On a computer with internet access, create the Dockerfile.
   Important: Remember that for any script you write, the line endings must be appropriate for the operating system where the service runs. Many text editors can perform end-of-line (EOL) conversion.

       #############################################
       # A sample Dockerfile for installing JDK. #
       #############################################
       FROM debian:12-slim
       RUN apt update -y \
         && apt upgrade -y \
         && apt install -y  \
         ca-certificates \
         && apt install -y --no-install-recommends \
         && apt clean all
       #  install jdk
       RUN DEBIAN_FRONTEND=noninteractive apt-get install -y wget apt-transport-https gpg \
              && wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null \
              && echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list \
              && DEBIAN_FRONTEND=noninteractive apt-get update \
              && DEBIAN_FRONTEND=noninteractive apt-get install -y temurin-21-jdk \
              && apt-get clean all

       #  set JAVA_HOME variable
       ENV JAVA_HOME=/usr/lib/jvm/temurin-21-jdk-amd64

   For more information, see https://docs.docker.com/engine/reference/builder/.
2. Install Python and pip.

       #install the Debian-included Python and the pip package.
       RUN apt-get update && apt-get install -y python-is-python3 python3 python3-pip && apt-get clean

3. Install the spotfire package.

       RUN pip install spotfire --break-system-packages

4. Optional: If you need or want to use a Python interpreter that is not bundled with Spotfire Service for Python, then update the following in the Dockerfile.
   1. Install a compatible Python interpreter. See Custom Python interpreter for more information.
   2. Set the environment variable SPOTFIRE_PYTHON_HOME to the path to the directory for the installed Python interpreter that you want to use.
   3. Using `pip`, install the spotfire Python package (available at https://pypi.org/project/spotfire/).
5. Build the image specifying the name and tag.
   Use the command `docker build -t <name:version>`, as follows:

       docker build -t pysrv:258 .

   For more information, see https://docs.docker.com/engine/reference/commandline/build/.
6. Save the image to a .tar file.
   Use the command `docker save -o <name-version>.tar <name:version>`, as follows:

       docker save -o pysrv-258.tar pysrv:258

   For more information, see https://docs.docker.com/engine/reference/commandline/save/.
7. If you have already installed the service from the Spotfire Server Nodes & Services administration page, and if it is running, then stop the service.
8. Transfer the .tar file to the target computer (where the node manager is running).
9. Load the .tar file into the node manager.
   Use the command `docker load -i <name-version>.tar`, as follows:

       $ sudo docker load -i pysrv-258.tar
       f2419d350464: Loading layer [==================================================>]  329.5MB/329.5MB
       Loaded image: pysrv:258
       $ docker images
       REPOSITORY              TAG                 IMAGE ID            CREATED             SIZE
       pysrv                 258                 9941b68e7f65        17 hours ago        517MB

   For more information, see https://docs.docker.com/engine/reference/commandline/load/.
10. On the computer running the Spotfire Server, export the service configuration file custom.properties:

        config export-service-config --capability=PYTHON --deployment-area=<your deployment area name>

    See the export-service-config page in the Spotfire® Server and Environment - Installation and Administration guide for more information.
11. Edit the settings in the custom.properties file, specifying the name and tag of your custom image, and indicating that the docker image identifier should be used directly, without building an image on top of it.

        use.engine.containers: TRUE
        docker.image.name: <name:version>
        use.immutable.container=true

    See Docker container built for no internet access for more information.
12. On the computer running the Spotfire Server, import the service configuration:

        config import-service-config --config-name=<new-config-name>

    See the import-service-config page in the Spotfire® Server and Environment - Installation and Administration guide for more information.
13. From the Spotfire Server Nodes & Services administration page, install the service, specifying the configuration to use, and then start the service.

    If you have already installed the service, then, under the node manager, select the service and click Edit. From the Configuration drop-down list, select the new configuration.

See Installing the service on a node manager for a Spotfire Server and Configuring the Service for more information.