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:
Navigate to the parent folder of your virtual environment in terminal
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:
Ask your IT department to allow Sensmetry’s proxy at
https://keygen.sensmetry.com, and include a link to this documentation. The IP address ofkeygen.sensmetry.comis meant to be34.51.251.77indefinitely.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:
Open the download page and press F12 to open your browser’s developer tools, then select the Network tab.
Type the file extension, such as
vsixorwhl, into the Network tab’s filter box.Enter your license key and click the download button.
Select the failed request whose domain contains
r2.cloudflarestorage.com, and look at its Response Headers:Headers such as
Via,X-ZscalerorX-Forcepoint, or aservervalue other thancloudflare, mean your network blocked the request.server: cloudflaretogether with acf-rayheader means the request reached Cloudflare and the cause lies elsewhere.
Type
sensmetryinto 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
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
.sysmlfile, or files if the model spans severalFor Python library issues, the
.pyscript as well
For VS Code Extension issues, please also provide the Syside output log by following these steps:
Open the Output panel:
Press Ctrl/Cmd+Shift+U or
Press Ctrl/Cmd+Shift+P and type “Output: Focus on Output View”
In the Output panel, select “Syside” from the dropdown menu (instead of “Tasks”)
Copy the entire log output and include it in your report