# Installation & Setup

{% hint style="warning" %}
Installation options have been changed in SpecSync v3. For older releases check the [Older versions](/specsync/reference/older-versions.md) reference page.
{% endhint %}

SpecSync for Azure DevOps can be installed in different ways depending on the project context. The following table contains an overview of the installation options. The detailed installation instructions can be found by clicking the name of the option.

| Option                                                                                     | Supported Platforms           | Prerequisites                                | Notes                                            |
| ------------------------------------------------------------------------------------------ | ----------------------------- | -------------------------------------------- | ------------------------------------------------ |
| [.NET tool](/specsync/installation/dotnet-core-tool.md) (NuGet, Download)                  | Windows, Linux, macOS, Docker | .NET 6 SDK or later (including .NET 7, 8, 9) | Recommended                                      |
| [.NET Console App](/specsync/installation/dotnet-console.md) (NuGet, Download)             | Windows                       | .NET Framework 4.6.2 or later                | Compatible with SpecSync v2.1 usage              |
| [Native binaries for Linux or macOS](/specsync/installation/native-binaries.md) (Download) | Linux, macOS                  | -                                            | Larger package (\~35MB)                          |
| [Official SpecSync Docker image](/specsync/installation/docker-image.md) (Docker Hub)      | Windows, Linux, macOS         | Docker (Linux containers)                    | Ready-to-run images that require no installation |

{% embed url="<https://youtu.be/czUI-geOYmY>" %}
Video tutorial about installing SpecSync as a .NET tool
{% endembed %}

Once SpecSync has been installed, you need to setup and configure it before the first use. Check the [Setup and Configure](/specsync/installation/setup-and-configure.md) page for the details.

The [Command line reference](/specsync/reference/command-line-reference.md) page contains all available commands and options you can perform with SpecSync and the [Configuration](/specsync/reference/configuration.md) page contains the reference documentation for the SpecSync configuration file.

Please also review all [synchronization and test result publishing features](/specsync/features.md) as well.

{% content-ref url="/pages/-MDK0Jxsgj07YzuV38X6" %}
[Setup and Configure](/specsync/installation/setup-and-configure.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LVwFCLgktB9AOsohdYl" %}
[Command line reference](/specsync/reference/command-line-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LVwFCLiKB3ACJLwVZGP" %}
[Configuration reference](/specsync/reference/configuration.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MDJESYa6TthLjfxExvi" %}
[Features](/specsync/features.md)
{% endcontent-ref %}

{% hint style="info" %}
For setting up SpecSync for for a working example project, you can also check the [Getting started](/specsync/getting-started.md) guide.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.specsolutions.eu/specsync/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.