Troubleshooting

Each entry below starts from a symptom you can see. If yours is not among them, the community forum is where Syside users work problems out together.

If you need direct support, please check the Help us help you section for what to include in your report, then email us at syside.support@sensmetry.com.

Installation issues

ModuleNotFoundError: No module named 'syside'

This error occurs when the Syside Python Library & CLI is installed in a virtual environment that hasn’t been activated. To resolve this:

  1. Navigate to the parent folder of your virtual environment in terminal

  2. Run the activation command for your platform, which Activate the environment lists. With uv there is nothing to activate: run the script as uv run python script.py

import syside then succeeds in that terminal.

The extension does not work under WSL

WSL runs Linux, so the Windows build of the Syside VS Code Extension does not work inside it. Install the Linux version of the extension there instead.

Licensing and download issues

Syside reports that no license is active

Syside runs only with a license, and it has none in effect: it found no license key in your editor, the keyring or SYSIDE_LICENSE_KEY, the licensing server rejected the key it found, or the licensing server could not be reached. Enter your license key following the extension’s activation steps or the Python library’s. The Syside output channel in your editor names the reason the check failed.

If activation fails because the licensing servers cannot be reached, follow the next entry.

License activation or downloads fail: the license servers are unreachable

Syside activates and validates licenses against keygen.sh, reached directly or through Sensmetry’s proxy. A strict corporate firewall commonly blocks both, which surfaces as failed activation, or as Syside downloads that fail.

Test both endpoints:

# test connectivity to Sensmetry's proxy
curl -i https://keygen.sensmetry.com/api/v1/ping

# test connectivity to the keygen.sh service behind it
curl -i https://api.keygen.sh/v1/ping

A reachable endpoint answers with status 200, as in HTTP/2 200. Anything else, including a timeout or a connection reset, means the address is blocked.

If either endpoint answers 200, Syside can validate licenses. A persistent activation failure is then something else, so contact syside.support@sensmetry.com. If neither answers:

  1. Ask your IT department to allow Sensmetry’s proxy at https://keygen.sensmetry.com, and include a link to this documentation. The IP address of keygen.sensmetry.com is meant to be 34.51.251.77 indefinitely.

  2. While waiting for approval, request a temporary offline license from syside.support@sensmetry.com. If you already have an offline license, then follow Offline license.

A download from this site fails: “Could not reach the download server”

When you click a download button, your browser asks keygen.sh for the file, and keygen.sh redirects it to Cloudflare R2 (*.r2.cloudflarestorage.com), where the files are stored. Corporate web filters often block Cloudflare R2 by default. If that route fails, the button shows “Retrying via proxy…” and fetches the file through Sensmetry’s proxy at keygen.sensmetry.com instead, so the download only fails when the proxy is blocked as well.

The fix is the same as for activation: ask your IT department to allow https://keygen.sensmetry.com (IP address 34.51.251.77). Unblocking Cloudflare R2 is not needed. To confirm the cause first, and to give IT the details:

  1. Open the download page and press F12 to open your browser’s developer tools, then select the Network tab.

  2. Type the file extension, such as vsix or whl, into the Network tab’s filter box.

  3. Enter your license key and click the download button.

  4. Select the failed request whose domain contains r2.cloudflarestorage.com, and look at its Response Headers:

    • Headers such as Via, X-Zscaler or X-Forcepoint, or a server value other than cloudflare, mean your network blocked the request.

    • server: cloudflare together with a cf-ray header means the request reached Cloudflare and the cause lies elsewhere.

  5. Type sensmetry into the filter box instead. The requests listed show whether the retry through the proxy ran and how it failed.

If the headers show your network blocking the request, send the screenshots to your IT department with the allow request above. If they show server: cloudflare, or the download still fails once the proxy is allowed, email syside.support@sensmetry.com with screenshots of both filtered lists, or the exported HAR file: in Chrome or Edge, Export HAR (sanitized) at the top of the Network tab; in Firefox, right-click a request and choose Save all as HAR.

Installing the Python library fails at the package index

The Python Library & CLI installs from https://pypi.pkg.keygen.sh, which asks for the user license and your license key as the password. A 401 or 403 status in the error means the index turned the key down: check that the key is complete and the user is license, or, with uv, store the key again with uv auth login. A timeout or a connection reset means a firewall blocks the index. Ask your IT department to allow it, or download the wheels on a machine that reaches it.

License file cannot be validated

A rejected license file has usually run out, since a file can work for up to a year from the day it was downloaded, or sits where Syside does not look: the path in SYSIDE_LICENSE_FILE if that is set, otherwise the place in your home directory that Import the license file gives. The third cause is a file written by an outdated version of syside-license. Where the syside-license tool is installed, see what the file allows and when it stops:

syside-license show license

It prints the license expiry, the date the file stops working offline, the path it was loaded from, and what it entitles. syside-license show location prints where Syside looks for the file. A file that has run out, or came from an outdated syside-license, is replaced: get a new file and import it again. One lying elsewhere is moved to where Syside looks. The next import syside or CLI run then succeeds. If the file is current, in the right place, from a current syside-license and still rejected, email syside.support@sensmetry.com with the first eight characters of your license key and the syside-license show license output.

VS Code Extension issues

SysMLv2 Views panel is hidden

A custom VS Code layout can hide the SysMLv2 Views panel without an obvious button to reveal it. To find it again:

  1. Press Ctrl/Cmd+P to open the Quick Open menu

  2. Type view SysMLv2 Views and press Enter

The panel opens.

Help us help you

When reporting an issue, please provide the following information to help us diagnose your problem:

  • A clear description of the issue you are experiencing

  • The relevant .sysml file, or files if the model spans several

  • For Python library issues, the .py script as well

For VS Code Extension issues, please also provide the Syside output log by following these steps:

  1. Open the Output panel:

    • Press Ctrl/Cmd+Shift+U or

    • Press Ctrl/Cmd+Shift+P and type “Output: Focus on Output View”

  2. In the Output panel, select “Syside” from the dropdown menu (instead of “Tasks”)

  3. Copy the entire log output and include it in your report