Preparing for an air-gapped installation

To install a self-hosted Instana backend in an environment that is not connected to the internet, ensure that the following prerequisites are met:

1. Configure a local image registry to proxy Instana's image registry (artifact-public.instana.io) transparently.

2. Log on to Docker registry with your download key:

   docker login artifact-public.instana.io --username _ --password <download key>
   

3. List the images that you need to mirror by running the following command:

   kubectl instana versions list-images
   

4. Pull the images from the artifact-public.instana.io registry, re-tag these images to a local image registry, and then push these images to the local image registry. See the following example commands:

   docker pull <artifact-public.io image>
   

   docker tag <artifact-public.io image tag> <local registry image tag>
   

   docker push <local registry image tag>
   

5. Before you install Instana, locate the values YAML file that you create in the Creating and configuring the values file section, and modify the file by pointing image.registry to the local image registry. See the following example:

   image:
   registry: <your_local_image_registry>
   

   Replace <your_local_image_registry> with the name of your local image registry.

   For more information, see Using advanced Operator configuration.