Skip to content

Settings

Click the Settings button in the left sidebar's rail (gear icon, also in the rail's ⌄ menu). The sidebar switches to the settings sections — grouped under collapsible App, Panels, Data, and System headers — and the Settings tab opens. All settings live on one scrollable page: click a section in the sidebar to jump straight to it, and the sidebar highlights the section you're reading as you scroll.

Settings sidebar nav beside the top of the settings page

The grouped sidebar nav next to the one-page settings pane.

Settings Tab Behavior

Only one Settings tab can be open per workspace. If already open, clicking the Settings button activates the existing tab.

Searching settings

With the Settings view active, use the rail search (Cmd+F / Ctrl+F) to search every setting — names, descriptions, and synonyms all match ("fps" finds Framerate, "telemetry" finds usage analytics). Picking a result scrolls to the exact control and highlights it briefly.

Sections with adjustable defaults show a Reset to defaults next to their title when something in them has been changed.

Team and account

Your organization sits at the top of the settings sidebar, showing its name and your role. Click it to open the team menu. It lists every organization you belong to, so you can switch between them. It also offers Add organization, to accept an invitation, join another organization, or create one, and Manage team, which opens the organization in Zelos Cloud.

If you sign in without an organization, Zelos asks you to create or join one before you go on. While it cannot reach Zelos Cloud to check, the row reads No organization yet · Set up your organization, and clicking it opens the same prompt.

Your account lives at the bottom of the same sidebar. Click Sign in when you're signed out. Once signed in, the row shows your name and email, and its menu offers Billing (opens Zelos Cloud) and Log out. Signing out never deletes local workspaces. Your work stays on your computer.

App

Appearance

Theme — control the app's appearance:

  • System - Follow your OS light/dark setting
  • Light - Always use the light theme
  • Dark - Always use the dark theme (default)

Changes apply immediately.

Updates

  • Zelos App - Shows the installed version. Check for Update checks immediately (the app also auto-checks every 5 minutes); when an update is available, Update and Restart App installs it in one click. Release Notes shows what changed — a NEW badge appears when updates are available.
  • Update Channel - Release (default) for stable releases, or Alpha for pre-release versions.

Updates on Ubuntu

Zelos updates through Ubuntu's system updater, and the Update Channel switches the Zelos apt source. Neither asks for a password when your account is an administrator. Otherwise Ubuntu asks an administrator to approve the update.

If Zelos shows No newer version yet, the Zelos apt repository has not published that version yet. Try again in a few minutes.

Guided tour

  • Take the tour - Start begins the guided tour again: you install a simulated battery site and find a fault in it. Everything is simulated on this machine, nothing is written to disk, and leaving removes all of it. It needs you signed in to an organization.

Panels

Default options applied to newly created panels, one section per panel type. These preferences are stored locally in the app (per installation) and are not synced to the agent or other devices. Changing a default never affects existing panels — each panel keeps the options it was created with, and any option can still be overridden from an individual panel's settings.

  • General - Cross-panel signal defaults: Show empty signals (keep signals visible when they have no data in the current view; on by default) and Show full name (show each signal's full path instead of just its name; off by default).
  • Plot - Legend visibility and placement, live values, Interpolation (Linear default, Stepped, or Spline), Sample markers and marker size, Line width and pattern, Area fill, axis layout, stacked-plot alignment, and hiding the X/Y axes.
  • Log - Which columns are shown (timestamps, levels, producers, sources, file, line), message wrapping, font size, auto-scroll, and buffer size.
  • Raw - Font size, auto-scroll, and buffer size.
  • Table - Font size.
  • Value - Column count and font size.
  • State - Legend visibility and placement, live values, label font size, stacked-axis alignment, and the time axis.
  • Action - Parameter column count, parameter persistence, and how actions execute (Enter to execute, inline button).

Data

Storage

Data Retention

How long to keep live data before it is pruned:

Options: 1, 2, 4, 8 (default), 12, or 24 hours.

Longer retention uses more resources, but allows viewing older live data without reconnecting. In memory mode this increases RAM usage; in disk mode it can also increase disk usage. This setting applies to both memory and disk stores. Disk mode survives restarts, but data older than the retention window is still pruned.

Store Type

Choose how live data is stored:

  • Memory - Fastest option. Live data is kept in memory only and is lost on restart.
  • Disk - Stores live data on disk so it survives normal restarts.
  • Changing the store type requires restart.
  • Disk store is currently in beta.

On a normal shutdown, the disk-backed store flushes remaining buffered data before exit. Force-quitting the app or agent can still lose the newest buffered samples.

Memory Limit

Shown when Store Type is set to Memory

Maximum memory usage before live data pruning begins:

  • Set as percentage of system memory or absolute value (MB/GB/TB)
  • Default: 25% of system memory
  • Minimum: 100 MB
  • Unlimited: Disable the memory cap and rely on time-based retention only

Disk Size Limit

Shown when Store Type is set to Disk

Maximum disk space for live trace data:

  • Set in MB, GB, or TB
  • Unlimited disables size-based pruning
  • When the limit is exceeded, the oldest on-disk data is pruned first

Store Folder

Shown when Store Type is set to Disk

Choose where disk-backed live data is stored:

  • Leave empty to use the default app data location
  • Changing the folder requires restart

Clear Store Data

Remove all live data from the current store:

  • Works for both memory and disk modes
  • Cannot be undone

Diagnostics

Logs Folder

  • Opens the folder containing application log files
  • Logs capture errors, warnings, and diagnostic information

Log Retention

How long to keep log files before they are deleted:

  • Options: 1, 2, 3, 7, 14, or 30 days
  • Default: 14 days

Older logs are removed automatically.

Report a problem

Send a problem report directly from the app:

  • Sends your description, optional email, the last 24 hours of logs, and system info to Zelos support
  • Log bundles are size-capped and scrubbed of credentials before upload
  • The dialog's Export button builds the same zip locally without sending — inspect it first, then share it manually. If the agent is unreachable, Export saves redacted log tails instead
  • Also available from the crash screen when something goes wrong

Share usage analytics

  • Enabled by default
  • Helps improve the app by sending usage data: features used, clicks, and session replays
  • Turn it off to stop all usage analytics and session replays from this installation
  • Crash reports are separate, and still go to Zelos when it is off

System

Advanced

Framerate

UI update frequency for time axis:

  • Options: 1, 5, 10, 15, 20, 25, 30, or 60 fps
  • Default: 30 fps
  • Lower rates reduce CPU usage

Minimum Fetch Interval

Throttles data refresh rate:

  • Options: None, 30 ms, 60 ms, 100 ms, 250 ms, 500 ms, 1000 ms
  • Default: 100 ms
  • Prevents rapid re-fetching

Plot Optimization

Data query strategy:

  • M4 (default) - Intelligent downsampling for better performance
  • None - Full resolution (raw data)

Developer Mode

Unlocks the Developer section below.

Network

Agent Bind Address

Which network interface the desktop agent listens on:

  • Localhost only (recommended) - Only this machine can reach the agent
  • All interfaces - Any device that can reach this machine can reach the agent
  • Custom... - Enter one address, such as 192.168.1.10 or [::1]

Localhost access always stays available. Changing the bind address requires a restart.

The agent does not authenticate clients

On any setting other than localhost, every device that can reach this machine can query traces and call tools. Use it only on trusted networks.

Developer

Visible while Developer Mode is on.

  • Debug Logs - Saves additional logging during trace capture; helpful for troubleshooting
  • Performance Overlay - Shows performance metrics; toggle with Ctrl+D
  • Restart Agent - Manually restart the background agent process

Next Steps