Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 49 additions & 22 deletions docs/pages/choose-an-edition/teleport-cloud/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -135,37 +135,64 @@ Proxy recording mode is disabled for cloud customers

The ability to download recordings for offline viewing will be available in a future release.

## Upgrading
## Updates

### Will Teleport be automatically upgraded with each release?
### Will Teleport be updated automatically?

Teleport Cloud follows the Teleport [Upcoming
Releases](../../upcoming-releases.mdx) timelines.
The Teleport Auth Service and Teleport Proxy Service for Teleport Team and Teleport Enterprise Cloud
are automatically kept up to date with patches and minor releases following the release schedule
described in [Teleport Upcoming Releases](../../upcoming-releases.mdx).

- Major version upgrades for customer Auth and Proxy Servers occur after the
first minor release (for example (=teleport.major_version=).1.0) of Teleport.
This typically happens within one month of a new major release of Teleport
becoming available.
- After the first minor release, subsequent minor and patch upgrades typically
occur within a week.
- Your Teleport tenant will NOT be automatically upgraded to the next major version if any
Teleport agents connected to the cluster are not compatible (> 1 major version behind).
- Major version updates for the Teleport Auth Service and Teleport Proxy Service typically occur
one month after new major versions are released.
- Minor updates and patches typically occur between one day and a week after a release.
- Teleport Auth Service and Teleport Proxy Service updates are pushed to Teleport cloud accounts
during your scheduled maintenance window.
- Teleport agents are only updated automatically if you enroll them in automatic updates.

### Are upgrades times configurable for my Teleport Enterprise Cloud tenant?
If you have Teleport agents connected to a Teleport Team or Teleport Enterprise cluster that are
more than one major version behind, you might experience compatibility issues unless your agents
are enrolled in automatic updates.

Yes, you can set the window start time that works best for your organization
for upgrades. Teleport provides a scheduled maintenance time window for any
upgrades, patches and other required updates for all tenants. An upgrade for
your tenant will not start earlier than the window start time you set.
To get version information for your agents, see [How can I find version information on
connected agents?](#how-can-i-find-version-information-on-connected-agents).
For information about enrolling in automatic agent updates, see [Enroll an agent into automatic
updates](../../management/operations/enroll-agent-into-automatic-updates.mdx).

To set the window start time select your username in the Web UI, then the Help
& Support option from the drop-down. The Scheduled Upgrades section within that
page allows you to configure the window start time.
For more information about automatic updates and compatibility issues, contact
[Teleport support](https://goteleport.com/support/).

Teleport recommends subscribing to the Teleport Enterprise Cloud updates at
[status.teleport.sh](https://status.teleport.sh) to keep up to date on
### Are updates times configurable for Teleport Enterprise Cloud?

Yes, Teleport provides a scheduled maintenance time window for updates and you can set
the start time for the maintenance window that works best for your organization. The
scheduled maintenance windows applies for all updates, including patches and agent updates
for all Teleport Cloud accounts. Updates for your cluster won't start earlier than the
maintenance window start time you set.

To set the maintenance window start time, select your username in the Teleport Web UI,
then click **Help & Support**. Under Scheduled Upgrades, you can see the current
maintenance window start time. Click **Edit** to set a different start time for
scheduled maintenance.

Teleport recommends you check the status of Teleport Cloud at
[status.teleport.sh](https://status.teleport.sh). From the status page, click
**Subscribe to Updates** to get email notifications whenever Teleport Cloud creates,
updates, or resolves an incident and stay informed about scheduled maintenance and
new releases.

### When are agents automatically updated?

Teleport Team and Teleport Enterprise must be set to receive automatic updates
to use the Teleport Cloud version server for automatic agent updates. With automatic
agent updates, agents periodically check the version server for new releases and
update the software when new versions are found.

If you enroll in automatic agent updates, Teleport agents are automatically
updated after your Teleport cluster is updated during your scheduled maintenance
period. For information about enrolling in automatic agent updates, see [Enroll an
agent into automatic updates](../../management/operations/enroll-agent-into-automatic-updates.mdx).

### How can I find version information on connected agents?

To find the version of Teleport agent is attached to your cluster, run the
Expand Down