Docs / Platform Settings / Agent Settings

Agent Settings

The Agents tab allows you to configure agent update behaviour and manage the agent scripts for each supported platform.

Accessing Agent Settings

  1. Click Configuration Settings in the sidebar
  2. Select the Agents tab

Agent Update Settings

Configure how agent and reporter scripts receive updates from Platform One.

Update Channel

Choose when your ZEM Cloud instance receives agent script updates:

  • Manual Updates - Scripts will not auto-update. Use the script editors to manually download and install updates when needed.
  • Early Access - Automatically downloads and installs updates as soon as they are released. Best for development and testing environments.
  • Standard (Recommended) - Automatically downloads updates 10 days after their release, giving time to identify any issues. Recommended for production environments.
  • Delayed - Always stays one version behind the latest release. Provides maximum stability by only using well-tested previous versions.

Platform Scripts

ZEM Cloud supports agents for multiple platforms. Each platform has its own agent and report scripts.

Supported Platforms

  • Ubuntu/Debian - Bash scripts for Debian-based Linux distributions
  • Arch Linux - Bash scripts for Arch-based Linux distributions
  • Fedora - Bash scripts for Fedora and RHEL-based distributions
  • macOS - Bash scripts for macOS systems
  • Windows - PowerShell scripts for Windows 10/11 systems

Script Types

Each platform has two scripts:

  • Agent Script - The main agent that handles updates, telemetry, and action processing
  • Report Script - A lightweight reporter that sends status updates to the server

Script Editor

The script editor allows you to view and modify agent scripts for each platform.

Viewing Scripts

  1. Expand the platform section in the sidebar (e.g., Ubuntu/Debian)
  2. Click on "Agent Script" or "Report Script"
  3. The current script is displayed in the editor

Version Information

Each script section shows:

  • Current Local Version - The version currently installed on your ZEM Cloud instance
  • Official Release Version - The latest version available from Platform One

An update badge appears next to the platform name when a newer version is available.

Updating Scripts

When an update is available, you'll see an "Update Available" notification:

  1. Review the version change information
  2. Click Download & Update to install the new version
  3. The script will be updated and endpoints will receive the new version on their next check-in

Editing Scripts

To manually edit a script:

  1. Click Unlock and Edit
  2. Read the warning about potential risks
  3. Click Accept & Edit to proceed
  4. Make your changes in the editor
  5. Click Save to save your changes

Rollback

If you've made changes and need to revert:

  • Rollback - Revert to the previous backup (only available after making changes)
  • Restore Official Release - Download and restore the latest official version from Platform One

Update Badges

The sidebar shows update indicators:

  • Platform Badge - Shows when any script for that platform has an update available
  • Script Badge - Shows on individual scripts (Agent Script, Report Script) when that specific script has an update

Best Practices

  • Use the Standard update channel for production environments
  • Test updates in a development environment before deploying to production
  • Keep agent versions consistent across your fleet when possible
  • Review release notes before updating to understand changes