Tray App (Syslok Agent)

Overview

The Syslok Tray App is a lightweight desktop agent (~5MB) built with Tauri. It sits in your system tray and provides managed, persistent remote access with user consent required for each session.

The app can be configured to auto-start on boot and updates itself automatically. It is designed for end-user machines where the user should have control over when and how remote access occurs.

Installation

Download the latest version from syslok.com/download. Choose the installer for your platform:

Platform	Format	Size
Windows	.msi	~5 MB
macOS	.dmg (universal binary)	~5 MB
Linux	.AppImage	~5 MB
Linux (Debian)	.deb	~4 MB

First-Run Setup

When you launch the tray app for the first time, a registration wizard guides you through the initial setup:

Server URL — Enter your Syslok server URL. This is pre-filled for cloud-hosted users.
Log In — Authenticate with your Syslok account credentials.
Name Your Device — Give this machine a recognizable name (e.g., "Emily's MacBook" or "Front Desk PC").

Once registration is complete, the device appears in your Syslok dashboard immediately.

System Tray

The tray icon indicates the current state of the agent:

Idle No active session. The agent is connected and waiting.

Pending An incoming connection request is waiting for your approval.

In Session A remote session is currently active.

Error Connection lost or configuration issue.

Right-click the tray icon to access the context menu:

Status — View current connection state and session info
Open Preferences — Configure the agent
Generate Session Code — Create a 6-digit code to share with an operator
Quit — Exit the tray app

Session Consent

When an operator requests remote access to your machine, a consent dialog appears on screen. The dialog displays:

The operator's name and organization
The permissions being requested (screen view, keyboard, mouse, file transfer)
The estimated session duration

You can Accept or Decline the request. There is also an optional setting to "Always allow from this operator", which skips the consent dialog for future requests from the same person.

Session Codes

You can generate a 6-digit session code from the tray menu to share with an operator. The operator enters this code in the Syslok dashboard to initiate a connection to your machine.

Session codes expire after 5 minutes. If the code is not used within that window, it becomes invalid and a new one must be generated.

Preferences

The following settings are available in the Preferences window:

✓

Auto-start on login — Launch the tray app automatically when you log in to your computer.

✓

Notification settings — Control how you are notified about incoming session requests.

✓

Require approval for every session — When enabled, the consent dialog is shown for every request, even from previously trusted operators.

✓

Maximum session duration — Set an upper limit on how long a single session can last.

✓

Server URL — Change the Syslok server the agent connects to.

Auto-Update

The tray app includes a built-in update mechanism. It checks for new versions periodically in the background. When an update is available, the app downloads it and prompts you to restart to apply the changes.

Updates are signed and verified before installation. You are never forced to update — the prompt can be dismissed and the update will be applied on the next manual restart.