Troubleshooting
This page contains common issues and their solution. To better understand the synchronization process that led to the error, you can try to re-run the synchronization with an additional --verbose option.
If you don't find your issues here, please contact support.
Unable to find or restore package error when installing or restoring SpecSync as a .NET tool
When you install SpecSync as a .NET tool, you might receive errors during the dotnet tool install SpecSync.Jira or the dotnet tool restore commands. The error message might contain Unable to find package SpecSync.Jira or The tool package could not be restored.
The problem is usually that there is a custom NuGet source configured in your organization that does not mirror SpecSync packages.
Solution 1: For the installation you can specify the official NuGet source by adding the --add-source https://api.nuget.org/v3/index.json --ignore-failed-sources options to the install or restore command.
E.g. the installation with specified NuGet source would be...
Solution 2: You can change your local NuGet configuration or the NuGet.config file of your project to include the official NuGet source https://api.nuget.org/v3/index.json. Alternatively you can ask the administrator of your custom NuGet source to mirror the SpecSync NuGet packages.
No usable version of libssl was found error when running SpecSync Linux binaries on Ubuntu 22.04
When the Linux binary package of an older SpecSync version is executed on Ubuntu 22.04 the synchronization might fail with the error message No usable version of libssl was found.
This is caused by the SSL library incompatibility between .NET Core 3.1 and Ubuntu 22.04.
Solution 1: You can use the Ubuntu 20.04 stable version for these SpecSync versions where you can have compatible SSL packages (libssl1.1).
Solution 2: Upgrade SpecSync for Jira to v1.1.1. Those versions use .NET 6 for the Linux binaries that are compatible with libssl3 available for Ubuntu 22.04.
Solution 3: The compatibility can also be achieved by downgrading and installing the necessary libssl library. This can be achieved by adding the following command to your Dockerfile (source: StackOverflow post):
Last updated