Offline Installation

This section provides instructions for installing SysIDE tools in secure environments without internet connectivity. This offline installation method is essential for users in enterprise settings where network security policies, company proxy restrictions, or air-gapped environments prevent direct access to our online licensing servers.

Note

The offline version of SysIDE does not connect to our licensing servers for license activation or validation. Instead, it uses a manual process for generating and importing license files, which are provided directly by the Sensmetry Support team. To obtain an offline license, please contact us at syside.support@sensmetry.com

Setup Equipment

  • A computer with internet access to download files

  • The offline computer/workstation where SysIDE is needed

  • A means to transfer downloaded files between your devices

Installation Steps

1. Preparation (on a computer WITH internet access)

1.1. Download the SysIDE Modeler .vsix file: Use our official download page https://docs.sensmetry.com/latest/modeler/install.html to get the latest SysIDE Modeler file and follow the manual installation instructions to obtain the .vsix file.

Warning

Do not use the VS Code Marketplace to download SysIDE Modeler for offline use, as the required .vsix file is not included there.

1.2. Download the SysIDE Automator .whl files: Use pip to download the necessary .whl files from our internal PyPI repository. These include: syside, syside-license, click, and colorama (on Windows). The files will be downloaded to the directory where the terminal is open.

python -m pip download syside syside-license --index-url \
    https://gitlab.com/api/v4/projects/69960816/packages/pypi/simple

If downloading for a different platform (for example, downloading on a Windows machine but planning to use on Linux), add the --only-binary=:all: --platform <platform> command line options, where <platform> is one of:

  • macosx_14_0_arm64 – for ARM Macs

  • macosx_14_0_x86_64 – for Intel Macs

  • win_amd64 – for Windows

  • manylinux_2_31_x86_64 – for Linux

Example for Linux target:

python -m pip download syside syside-license --index-url \
    https://gitlab.com/api/v4/projects/69960816/packages/pypi/simple \
    --only-binary=:all: --platform manylinux_2_31_x86_64

2. Installation (on the offline computer)

2.1. Transfer files: Transfer the Modeler .vsix file and Automator .whl files (there will be 3 or 4 files: syside, syside_license, click, and on Windows also colorama) to the computer without internet access.

2.2. Install SysIDE Modeler: Open VS Code (or an equivalent editor) and open the Command Palette (Ctrl+Shift+P for Windows/Linux, Cmd+Shift+P for macOS). Select Extensions: Install from VSIX. Once the popup appears, select the downloaded file and click Install.

2.3. Install SysIDE Automator: Open a terminal in your preferred location, create and activate a virtual environment.

python3.12 -m venv .venv # newer versions of Python also work
.venv\scripts\activate

python3.12 -m venv .venv # newer versions of Python also work
source .venv/bin/activate

python3.12 -m venv .venv # newer versions of Python also work
source .venv/bin/activate

Place all .whl files in the same directory as your .venv folder and run:

pip install [filename].whl

3. License Generation & Activation

3.1. Generate Machine ID: Open the Command Palette (Ctrl+Shift+P for Windows/Linux, Cmd+Shift+P for macOS) and select SysIDE Modeler: Copy machine ID. This copies the machine ID to your clipboard.

3.2. Send Machine ID: Send the machine ID for offline license activation to our support email: syside.support@sensmetry.com. Also, please attach your <LICENSE-KEY> if you are sending from a different email than the one the license key was sent to.

3.3. Import license files: Open the Command Palette (Ctrl+Shift+P for Windows/Linux, Cmd+Shift+P for macOS) and select SysIDE Modeler: Import SysIDE Modeler license and SysIDE Modeler: Import SysIDE Automator license respectively to import the .lic license files.

If the commands are not working for some reason, place the license files in the output location shown by the syside-license show location terminal command.

4. Updates

When updating versions, you only need to update the .vsix file and .whl files. Licenses only need to be renewed if the syside-license version changes.