> For the complete documentation index, see [llms.txt](https://docs.smartmerge.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smartmerge.de/getting-started/downloads.md).

# Downloads

Download Smart Merge V for web, desktop, and command-line workflows.

Smart Merge V is available as a web app, desktop app, and command-line archive. Use the option that matches where you work with your FiveM server files.

## Available downloads

| Option          | Link                                                                                                          | Best for                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Web app         | [app.smartmerge.de](https://app.smartmerge.de/)                                                               | One-off Quick Merge runs from a browser.                                                  |
| Windows desktop | [SmartMerge-V-Setup.exe](https://app.smartmerge.de/downloads/SmartMerge-V-Setup.exe)                          | Native folder access, Server Watcher, desktop notifications, and save dialogs on Windows. |
| Linux desktop   | [SmartMerge-V-linux-x86\_64.AppImage](https://app.smartmerge.de/downloads/SmartMerge-V-linux-x86_64.AppImage) | Native folder access, Server Watcher, desktop notifications, and save dialogs on Linux.   |
| CLI archive     | [smartmerge-cli.zip](https://app.smartmerge.de/downloads/smartmerge-cli.zip)                                  | Server automation, terminal-only Quick Merge, and CLI Server Watcher.                     |

{% hint style="info" %}
The download links point to the currently published Smart Merge V release. The web app can update more often than the desktop app and CLI, but the desktop and CLI download links stay stable.
{% endhint %}

## Understanding version numbers

Smart Merge V uses three-part version numbers such as `1.3.0`:

* The first number changes for a very large milestone or an update that is not compatible with an older setup.
* The second number changes for normal feature updates and improvements.
* The third number changes for smaller fixes to an existing release.

The **What changed** dialog keeps smaller fixes with the feature release they improve. It shows them as dated follow-up fixes when you expand that release instead of listing every fix as a separate version. Desktop and CLI downloads still use the complete three-part version so their automatic update checks always select the newest build.

## CLI archive contents

The CLI download is a ZIP archive. After extracting it, run the bundled CLI with Node.js:

```bash
node smartmerge-cli.mjs help
```

The archive also includes a small `README.txt` with the release version, requirements, and command summary.

## Requirements

| Tool        | Requirement                                                     |
| ----------- | --------------------------------------------------------------- |
| Web app     | A modern browser and access to the resource folders you select. |
| Desktop app | Windows or Linux with local access to the resource folders.     |
| CLI         | Node.js 24 or newer.                                            |

macOS desktop builds are not published yet. Use the web app or CLI from macOS if those workflows fit your setup.

## Which one should I choose?

Use the browser for a quick manual merge. Use the desktop app when you want native folder access, Server Watcher, desktop notifications, or startup behavior. Use the CLI when you want terminal commands, headless server automation, or a long-running watcher process.

Continue with [Choose Web, Desktop, or CLI](/getting-started/choose-web-or-desktop.md) for a comparison, or [Command Line Interface](/using-smart-merge-v/command-line-interface.md) for CLI setup.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.smartmerge.de/getting-started/downloads.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.