Migration Guide#
This guide covers the API and tooling changes required to migrate NVIDIA TensorRT workloads. The primary path is TensorRT 10.x to 11.x; an appendix covers TensorRT 8.x to 10.x. Platform-specific pages for NVIDIA DriveOS and Jetson/JetPack address deployment-target differences where they affect migration steps.
If you are unfamiliar with these changes, refer to the TensorRT sample code for clarification.
Choose Your Migration Path#
Use the tables below to pick the page that matches your starting version, deployment target, and integration surface. Each linked page includes paired before/after examples where applicable.
Migrating from TensorRT 10.x to 11.x (primary path)
If you… |
Start here |
|---|---|
Need the full 10.x -> 11.x overview (strong typing, plugin V3, removed APIs) |
|
Ship a Python application or build script |
|
Ship a C++ application |
|
Use trtexec or other CLI build/inference workflows |
|
Use the Safety Runtime (ISO 26262 automotive) |
|
Depend on IEngineInspector for engine introspection |
|
Deploy on NVIDIA DriveOS |
|
Maintain a Jetson / JetPack deployment |
TensorRT 11.4.1 supports NVIDIA JetPack 7.2.2 or later on Jetson AGX Orin and Jetson Thor, installed from the Linux SBSA package. Refer to Jetson migration. On NVIDIA JetPack 6.x, remain on a TensorRT 10.x release supported by the installed JetPack version. |
Migrating from TensorRT 8.x to 10.x (appendix)
If you… |
Start here |
|---|---|
Are still on 8.x and upgrading to 10.x first |
|
Need Python API deltas for 8.x -> 10.x |
|
Need C++ API deltas for 8.x -> 10.x |
|
Need trtexec changes for 8.x -> 10.x |
|
Need Safety Runtime changes for 8.x -> 10.x |
See also
- C++ API Reference
Full C++ API documentation.
- Python API Reference
Full Python API documentation.
- Version Compatibility
Engine compatibility across TensorRT versions and hardware.
- Security Considerations
Trust boundaries for engines, plugins, caches, and deployment artifacts.
- Troubleshooting
Common errors and debugging guidance.
- Upgrading TensorRT
Package-level upgrade instructions (pip, Debian, RPM, tar, zip) to complement API-level migration.
- TensorRT GitHub: Compare Releases
View API changes between releases using the GitHub compare tool.