Skip to main content
Version: 7.3

Offline installation

Deploy and run Axiomatics Services Manager (ASM) on environments without an internet connection, such as air-gapped servers.

Requirements​

For the offline installation of ASM, you need to acquire the following files from Axiomatics:

  • artifacts.zip
  • axiomatics-services-manager-VERSION.zip
  • registryData.zip
  • registryImage.tar

Contact Axiomatics Customer Support if you have not received them.

Offline installation procedure​

Place the files listed above under the same directory. Open a terminal, navigate to this directory, and follow the steps below to complete the offline installation of ASM:

  1. Restore the Docker Registry Image (registryImage.tar).

    docker load -i registryImage.tar

  2. Unzip the Docker Registry Image Volume (registryData.zip).

  3. Run the Registry Container.

    note

    Replace <ABSOLUTE_PATH_TO_DIR> with the path of the registry directory.

    docker run -d -p 5000:5000 --restart=always --name registry -v /<ABSOLUTE_PATH_TO_DIR>/registry:/var/lib/registry registry:2

  4. Unzip the artifacts ZIP file (artifacts.zip).

  5. Unzip the ASM ZIP file (axiomatics-services-manager-VERSION.zip).

  6. Copy the artifacts folder to the ASM docker folder.

    note

    Replace <PATH_TO_ASM> with the path to the ASM folder.

    cp -r artifacts /<PATH_TO_ASM>/axiomatics-services-manager-VERSION/docker/

  7. Update the axiomatics-services-manager-VERSION/docker/.env file with the following values:

    CONNECTION=offline

    REGISTRY=localhost:5000/
    note

    The file may be hidden.

  8. Follow the Install the application procedure starting with step 5. In case you want to run ASM on a machine with a hostname other than the default, you should instead start with step 4.