> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Clients

> Update Syteca Windows, macOS, and Linux Clients automatically when the Application Server upgrades, or manually from the Management Tool with Bulk Action.

Syteca offers two ways to update Clients to a new product version: **automatically**, as soon as each Client connects to a newer Application Server, or **manually**, from the Management Tool on your schedule. The procedure is identical for **Windows**, **macOS**, and **Linux** Clients - only the post-update status indicators differ by OS.

## Recommended approach

Use **automatic updates** unless you have a specific reason to manage the schedule yourself. With automatic updates on, a Client picks up the new version the next time it connects to the Application Server after the server itself has been upgraded. No further action is needed for that Client.

Use **manual updates** when you want to control the rollout - for example, to update a small pilot group of Clients first and the rest later.

<Note>
  After a Client is updated, the monitored data it recorded **before** the update remains accessible.
</Note>

<Warning>
  It may not be possible to update Clients of very old versions. In that case, **reinstall** the Client instead.
</Warning>

## Update automatically

Turn on automatic update for a single Client, or for an entire Client group at once.

<Steps>
  <Step title="Sign in with the right permission">
    Sign in to the Management Tool as a user with the [Client Configuration Management permission for Clients](/docs/administration/users/client-permissions).
  </Step>

  <Step title="Open Clients">
    Click **Clients** in the left navigation.
  </Step>

  <Step title="Open the Client or Client group">
    On the **Clients** tab, click the Client's name in the **Client Name** column. To configure an entire group at once, switch to the **Client Groups** tab and click the group's name in the **Client Group Name** column.

    <Note>
      Use the **Search** box and filters at the top of the page to find specific Clients (or the Search box at the top of the Client Groups page to find specific groups).
    </Note>
  </Step>

  <Step title="Enable automatic update">
    On the **Editing Client** (or **Editing Client Group**) page, on the **Properties** tab, scroll to the **Client Mode** section and select the **Update Client automatically** checkbox.
  </Step>

  <Step title="Finish">
    Click **Finish** in the bottom right.
  </Step>
</Steps>

<Check>
  The Client - or every Client in the group - updates automatically the next time it connects to an Application Server running a newer version of Syteca.
</Check>

## Update manually

Manual update is a two-stage workflow: first turn **off** automatic update on the Clients you want to control, then trigger the update from Bulk Action after the Application Server is upgraded.

### 1. Disable automatic update on selected Clients

<Steps>
  <Step title="Sign in">
    Sign in as a user with the [Client Configuration Management permission for Clients](/docs/administration/users/client-permissions).
  </Step>

  <Step title="Open Clients">
    Click **Clients** in the left navigation.
  </Step>

  <Step title="Open each Client">
    For each Client you want to manage manually, click its name in the **Client Name** column. (Or open a Client group from the **Client Groups** tab to apply the change to all Clients in the group.)
  </Step>

  <Step title="Clear the checkbox">
    On the **Properties** tab, in the **Client Mode** section, **clear** the **Update Client automatically** checkbox.
  </Step>

  <Step title="Finish">
    Click **Finish** to save the changes.
  </Step>
</Steps>

### 2. Run the update after the Application Server is upgraded

<Steps>
  <Step title="Upgrade the Application Server">
    First, [update the Application Server](/docs/administration/deployment/update-application-server) to the new version.
  </Step>

  <Step title="Open Clients">
    Sign back in to the Management Tool and click **Clients**.
  </Step>

  <Step title="Select the Clients to update">
    On the **Clients** tab, select the checkboxes next to the Clients you want to update.
  </Step>

  <Step title="Trigger the update">
    Click **Bulk Action** in the top left, then choose **Update Selected Clients** from the menu.
  </Step>
</Steps>

<Check>
  The selected Clients update to the latest version.
</Check>

<Frame caption="Triggering a manual update on selected Clients via Bulk Action.">
  <img src="https://mintcdn.com/syteca/0FlD-vkHsBA1azVX/images/administration/clients/update-bulk-action.png?fit=max&auto=format&n=0FlD-vkHsBA1azVX&q=85&s=9e53d2763e8bc4c6cefd7eb777cff1e5" alt="Clients page with checkboxes selected and Bulk Action menu showing Update Selected Clients" width="1910" height="493" data-path="images/administration/clients/update-bulk-action.png" />
</Frame>

## What happens to a not-up-to-date Client

A Client that's behind the Application Server version **continues to monitor user activity and send data** as normal - it just won't pick up new features or fixes until updated. Each OS shows a different post-update status indicator (and Linux and macOS have their own troubleshooting cases). For OS-specific status meanings, see:

<CardGroup cols={3}>
  <Card title="Windows Client status" icon="monitor" href="/docs/administration/clients/windows#read-the-client-status">
    Up-arrow and orange warning triangle indicators.
  </Card>

  <Card title="macOS Client status" icon="apple" href="/docs/administration/clients/macos#read-the-client-status">
    Includes Accessibility and Allow in Background fixes.
  </Card>

  <Card title="Linux Client status" icon="terminal" href="/docs/administration/clients/linux#read-the-client-status">
    Includes Rescue mode and Troubleshoot Rescue Mode.
  </Card>
</CardGroup>

## Related

<CardGroup cols={2}>
  <Card title="Windows Clients" icon="monitor" href="/docs/administration/clients/windows">
    Per-OS reference for Windows Client operation.
  </Card>

  <Card title="macOS Clients" icon="apple" href="/docs/administration/clients/macos">
    Per-OS reference for macOS Client operation.
  </Card>

  <Card title="Linux Clients" icon="terminal" href="/docs/administration/clients/linux">
    Per-OS reference for Linux Client operation.
  </Card>

  <Card title="Update the Application Server" icon="server" href="/docs/administration/deployment/update-application-server">
    The server upgrade that triggers Client updates.
  </Card>
</CardGroup>
