Offline Install for Air‐gapped Environments - OpenLiberty/liberty-tools-eclipse GitHub Wiki

Installing Liberty Tools for Eclipse in an offline, air-gapped environment requires that you first setup a mirror of the Liberty Tools repository and required dependencies. You can then host this mirror on an internal network for users to reference and install Liberty Tools from.

Creating the mirror

The repositories to mirror will generally be:

  1. The Liberty Tools for Eclipse repository
  2. The supported quarterly Eclipse repository
  3. The repositories listed in category.xml

This can be done by using the eclipse executable and running the following commands.

NOTE: The following commands are an example using Liberty Tools for Eclipse version 26.0.2 which supports Eclipse 2025-12. The repositories may be different for other versions of Liberty tools for Eclipse.

Liberty Tools for Eclipse

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.metadata.repository.mirrorApplication -source https://public.dhe.ibm.com/ibmdl/export/pub/software/openliberty/liberty-tools-eclipse/4.35/26.0.2/repository/ -destination file:/path/to/your/mirror/directory

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source https://public.dhe.ibm.com/ibmdl/export/pub/software/openliberty/liberty-tools-eclipse/4.35/26.0.2/repository/ -destination file:/path/to/your/mirror/directory

Eclipse 2025-12

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.metadata.repository.mirrorApplication -source https://download.eclipse.org/releases/2025-12/202512101000/ -destination file:/path/to/your/mirror/directory

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source https://download.eclipse.org/releases/2025-12/202512101000/ -destination file:/path/to/your/mirror/directory

LSP4MP

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.metadata.repository.mirrorApplication -source https://download.eclipse.org/lsp4mp/releases/0.16.0/repository/ -destination file:/path/to/your/mirror/directory

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source https://download.eclipse.org/lsp4mp/releases/0.16.0/repository/ -destination file:/path/to/your/mirror/directory

LSP4Jakarta

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.metadata.repository.mirrorApplication -source https://download.eclipse.org/lsp4jakarta/releases/0.2.5/repository/ -destination file:/path/to/your/mirror/directory

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source https://download.eclipse.org/lsp4jakarta/releases/0.2.5/repository/ -destination file:/path/to/your/mirror/directory

JDT.LS.CORE

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.metadata.repository.mirrorApplication -source https://download.eclipse.org/jdtls/milestones/1.56.0/repository/ -destination file:/path/to/your/mirror/directory

eclipse -nosplash -verbose -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source https://download.eclipse.org/jdtls/milestones/1.56.0/repository/ -destination file:/path/to/your/mirror/directory

Considerations

  1. The directory used as the mirror repository must be the same for all of the mirror commands. Eclipse will put everything in the same plugins directory and adjust the content.jar accordingly.

  2. Both the metadata and artifact commands must run and complete.

  3. The eclipse repo mirror is quite large but is needed as it contains things like lsp4e which is a transitive dependency of the project. This mirror may take 10+ minutes to complete.

Installing Eclipse

Once the mirror is created, you can install Liberty Tools from within the Eclipse IDE by going to Help > Install New Software and adding the mirror repository (local or remote directory) and then selecting "Liberty Tools" from the list of available plugins.