microsoft / microsoft/onnxruntime

[Feature Request] Onnxruntime DLL suffix

Open
#27,888 0 comments 1 reaction 2 assignees View on GitHub

@tianleiwu is already working on this.

Since Mar 28, 2026.

  • #27893 by @copilot-swe-agent — open
feature request
Dominant language
C++
Stars
21.9k
Forks
4.2k
Avg merge
4d 11h
Merged PRs (30d)
184

Description

### Describe the feature request

Perhaps it might be prudent to version suffix the dll to prevent applications from accidentally picking up the wrong DLL.

Instead of `onnxruntime.dll` you should ship `onnxruntime_17.dll` or `onnxruntime_23.dll`. Same should apply to linux shared library.

### Describe scenario use case

On windows it seems sometimes there is an onnxruntime.dll located at `C:\Windows\SYSTEM32\onnxruntime.dll`. This path is impossible to overwrite and is always preferred over any dll in the PATH.

This causes abi issues when running an application compiled with a newer version of onnxruntime.

```
The requested API version [23] is not available, only API versions [1, 17] are supported in this build. Current ORT Version is: 1.17.1
```

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.