v18.1.0
gravitational/teleportv18.1.0Jul 25, 2025by fheinecke
AI Summary
Teleport v18.1.0 introduces significant new capabilities including MCP server access with audit logging, VNet for SSH with native support, identifier-first login flows, and bound keypair joining for Machine ID. However, there is a critical warning: this release has a bug affecting Windows desktop access certificate revocation list publishing, and users are advised to skip to v18.1.1.
Key Highlights
- MCP server access with stdio-based connection proxying and audit logging support
- VNet for SSH adds native support enabling zero-configuration SSH client connections
- Identifier-first login flows provide username-first authentication experience
- Bound keypair joining for Machine ID offers more secure auto-recovery for bot certificates
- Sailpoint SCIM integration for synchronizing entitlement groups with Teleport access lists
Breaking Changes
- Windows desktop access CRL publishing is broken in this release - recommend upgrading to v18.1.1
- teleport-distroless container now disables client tools updates by default
New Features
- MCP server access with connection proxying and audit logging
- MCP for database access allowing Claude Desktop to query Teleport-protected databases
- VNet for SSH with native support and per-session MFA
- Identifier-first login flows
- Bound keypair joining for Machine ID with self-recovery capabilities
- Sailpoint SCIM integration for access list synchronization
- LDAP server discovery for desktop access via DNS
- Managed Updates canary support (max 5 canaries per group)
- Improved access requests UX in web UI
- Defined access-plugin preset role
- Added --listen flag to tsh proxy db
- Multi-account support for teleport discovery bootstrap
- TeleportRoleV8 support for Kubernetes Operator
- Fixed tctl/tsh failing on read-only file systems
- Fixed tsh aws failures for STS and other AWS services
- Fixed client tools managed updates downgrade issues
- tbot client now discards expired identities for automatic recovery
Full Release Notes
## Description
⚠️ _Warning:_ This release introduces an issue publishing certificate revocation lists for Windows desktop access. We recommend skipping straight to 18.1.1 for your `windows_desktop_service` instances.
If you have already upgraded your `windows_desktop_service` to 18.1.0 and aren't able to upgrade to 18.1.1, you can restore connectivity by:
1. Export cluster CRLs with `tctl auth crl --type=user --out=<prefix>`. This will create at least one file named `<prefix>-user-<suffix>.crl`.
2. Copy all exported files to your Windows environment.
3. For each file, run `certutil.exe -dspublish -f <prefix>-user-<suffix>.crl Teleport <suffix>`.
### MCP server access
Teleport now provides the ability to connect to stdio-based MCP servers with
connection proxying and audit logging support.
### MCP for database access
Teleport now allows MCP clients such as Claude Desktop to execute queries in
Teleport-protected databases.
### VNet for SSH
Teleport VNet adds native support for SSH, enabling any SSH client to connect to
Teleport SSH servers with zero configuration. Advanced Teleport features like
per-session MFA have first-class support for a seamless user experience.
### Identifier-first login
Teleport adds support for identifier-first login flows. When enabled, the
initial login screen contains only a username prompt. Users are presented with
the SSO connectors that apply to them after submitting their username.
### Bound keypair joining for Machine ID
The new bound keypair join method for Machine ID is a more secure and
user-friendly alternative to token joining in both on-prem environments and
cloud providers without a delegated join method. It allows for automatic
self-recovery in case of expired client certificates and gives administrators
new options to manage and automate bot joining.
### Sailpoint SCIM integration
Teleport now supports Sailpoint as a SCIM provider allowing administrators to
synchronize Sailpoint entitlement groups with Teleport access lists.
### LDAP server discovery for desktop access
Teleport's `windows_desktop_service` can now locate the LDAP server via DNS as
an alternative to providing the address in the configuration file.
### Managed Updates canary support
Managed Updates v2 now support performing canary updates. When canary updates
are enabled for a group, Teleport will update a few agents first and confirm
they come back healthy before updating the rest of the group.
You can unable canary updates by setting `canary_count` in your
`autoupdate_config`:
```yaml
kind: autoupdate_config
spec:
agents:
mode: enabled
schedules:
regular:
- name: dev
days:
- Mon
- Tue
- Wed
- Thu
start_hour: 20
canary_count: 5
strategy: halt-on-error
```
Each group can have a maximum of 5 canaries, canaries are picked randomly among
the connected agents.
Canary update support is currently only support by Linux agents, Kubernetes
support will be part of a future release.
### Improved access requests UX
Teleport's web UI makes a better distinction between just-in-time and long-term
access request UX.
### Other changes and improvements
* Fixed a bug causing `tctl`/`tsh` to fail on read-only file systems. [#57147](https://github.com/gravitational/teleport/pull/57147)
* The `teleport-distroless` container image now disables client tools updates by default (when using tsh/tctl, you will always use the version from the image). You can enable them back by unsetting the `TELEPORT_TOOLS_VERSION` environment variable. [#57147](https://github.com/gravitational/teleport/pull/57147)
* Fixed a crash in Teleport Connect that could occur when copying large clipboard content during desktop sessions. [#57130](https://github.com/gravitational/teleport/pull/57130)
* Audit log events for SPIFFE SVID issuances now include the name/label selector used by the client. [#57129](https://github.com/gravitational/teleport/pull/57129)
* Fixed an issue with `tsh aws` failing for STS and other AWS services. [#57122](https://github.com/gravitational/teleport/pull/57122)
* Fixed client tools managed updates downgrade to older version. [#57073](https://github.com/gravitational/teleport/pull/57073)
* Removed unnecessary macOS entitlements from Teleport Connect subprocesses. [#57066](https://github.com/gravitational/teleport/pull/57066)
* Machine and Workload ID: The `tbot` client will now discard expired identities if needed during renewal to allow automatic recovery without restarting the process. [#57060](https://github.com/gravitational/teleport/pull/57060)
* Defined `access-plugin` preset role. [#57056](https://github.com/gravitational/teleport/pull/57056)
* The `tctl top` command now supports the local unix sock debug endpoint. [#57025](https://github.com/gravitational/teleport/pull/57025)
* Added `--listen` flag to `tsh proxy db` for setting local listener address. [#57005](https://github.com/gravitational/teleport/pull/57005)
* Added multi-account support to teleport discovery bootstrap. [#56998](https://github.com/gravitational/teleport/pull/56998)
* Added `TeleportRoleV8` support to the Teleport Kubernetes Operator. [#56946](https://github.com/gravitational/teleport/pull/56946)
* Fixed a bug in the Teleport install scripts when running on macOS. The install scripts now error instead of trying to install non existing macOS FIPS binaries. [#56941](https://github.com/gravitational/teleport/pull/56941)
* Fixed using relative path `TELEPORT_HOME` environment variable with client tools managed update. [#56933](https://github.com/gravitational/teleport/pull/56933)
* Client tools managed updates support multi-cluster environments and track each version in the configuration file. [#56933](https://github.com/gravitational/teleport/pull/56933)
* Fixed certificate revocation failures in Active Directory environments when Teleport is using HSM-backed key material. [#56924](https://github.com/gravitational/teleport/pull/56924)
* Fixed database connect options dialog displaying wrong database username options. [#55560](https://github.com/gravitational/teleport/pull/55560)
Enterprise:
* Fixed SCIM user provisioning when a user already exists and is managed by the same connector as the SCIM integration.
* Added enrolment for a generic SCIM Integration.
## Download
Download the current and previous releases of Teleport at https://goteleport.com/download.
## Plugins
Download the current release of Teleport plugins from the links below.
* Slack [Linux amd64](https://cdn.teleport.dev/teleport-access-slack-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-slack-v18.1.0-linux-arm64-bin.tar.gz)
* Mattermost [Linux amd64](https://cdn.teleport.dev/teleport-access-mattermost-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-mattermost-v18.1.0-linux-arm64-bin.tar.gz)
* Discord [Linux amd64](https://cdn.teleport.dev/teleport-access-discord-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-discord-v18.1.0-linux-arm64-bin.tar.gz)
* Terraform Provider [Linux amd64](https://cdn.teleport.dev/terraform-provider-teleport-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/terraform-provider-teleport-v18.1.0-linux-arm64-bin.tar.gz) | [macOS amd64](https://cdn.teleport.dev/terraform-provider-teleport-v18.1.0-darwin-amd64-bin.tar.gz) | [macOS arm64](https://cdn.teleport.dev/terraform-provider-teleport-v18.1.0-darwin-arm64-bin.tar.gz) | [macOS universal](https://cdn.teleport.dev/terraform-provider-teleport-v18.1.0-darwin-universal-bin.tar.gz)
* Event Handler [Linux amd64](https://cdn.teleport.dev/teleport-event-handler-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-event-handler-v18.1.0-linux-arm64-bin.tar.gz) | [macOS amd64](https://cdn.teleport.dev/teleport-event-handler-v18.1.0-darwin-amd64-bin.tar.gz)
* PagerDuty [Linux amd64](https://cdn.teleport.dev/teleport-access-pagerduty-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-pagerduty-v18.1.0-linux-arm64-bin.tar.gz)
* Jira [Linux amd64](https://cdn.teleport.dev/teleport-access-jira-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-jira-v18.1.0-linux-arm64-bin.tar.gz)
* Email [Linux amd64](https://cdn.teleport.dev/teleport-access-email-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-email-v18.1.0-linux-arm64-bin.tar.gz)
* Microsoft Teams [Linux amd64](https://cdn.teleport.dev/teleport-access-msteams-v18.1.0-linux-amd64-bin.tar.gz) | [Linux arm64](https://cdn.teleport.dev/teleport-access-msteams-v18.1.0-linux-arm64-bin.tar.gz)