Skip to content

Rust Toolchain

Categories: rust

Renovate supports updating Rust Toolchain dependencies.

File Matching

By default, Renovate will check any files matching the following regular expression: /(^|/)rust-toolchain(\.toml)?$/.

For details on how to extend a manager's managerFilePatterns value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: rust-version.

Dependency types

This manager extracts the following depType values:

depType Description
toolchain Rust toolchain version

Default config

{
  "commitMessageTopic": "Rust",
  "managerFilePatterns": [
    "/(^|/)rust-toolchain(\\.toml)?$/"
  ]
}

Additional Information

This manager can be used to update the Rust toolchain version in rust-toolchain.toml and rust-toolchain files.

It supports both the TOML format and the legacy plain-text format as specified in the Rust toolchain documentation.

Version pinning

If you'd like to pin your toolchain to a particular version, the following configuration can be applied:

{
  "packageRules": [
    {
      "matchManagers": ["rust-toolchain"],
      "matchDepTypes": ["toolchain"],
      "rangeStrategy": "pin"
    }
  ]
}

Supported renovations

  • 1.90.0 → 2.0.0 (major version updates)
  • 1.90.0 → 1.91.0 (minor version updates)
  • 1.90.0 → 1.90.1 (patch version updates)
  • 1.90 → 2.0 (major range updates)
  • 1.90 → 1.91 (minor range updates)
  • nightly-2025-10-10 → nightly-2025-10-11 (nightly version updates)

With rangeStrategy: pin:

  • 1.90 → 1.90.0 (range pinning)
  • stable → 1.90.0 (stable channel pinning)
  • nightly → nightly-2025-10-11 (nightly channel pinning)

Note: The version numbers shown above are just examples for illustration purposes.