Documentation

Administrator guide

Uninstalling YuviRed

This page covers removing the YuviRed server from a computer, what stays behind, the option that erases the data, removing the agents from your other computers, and what happens to the license.

Read this first. Uninstalling the server does not delete your data, and it does not tell your other computers. Both are on purpose, and both need steps from you. **Best order: remove the agents from your computers first (section 4), then the server.** A computer whose server is gone keeps its agent, keeps trying to reach the server, and keeps applying the last policy its browser extension cached.


1. Remove the server (Apps and Features)

Purpose. Take the YuviRed programs and services off this computer. The data stays.

Prerequisites.

  • You are an administrator on the server.
  • If you may want the history later, take a copy of C:\ProgramData\YuviRed first (Administration, section 2). After a purge (section 3) nothing can be restored.
  • You know that computers you added keep their agent running and will keep trying to reach this server (section 4). Their check-in slows down to one try every 5 minutes after repeated failures.

Steps.

  1. Open Windows Settings, Apps, Installed apps (on Windows 10: Apps and Features).
  2. Find YuviRed Lite, click the three dots (or select it), and choose Uninstall, then confirm.
  3. Accept the Windows administrator prompt.

    You should see: the YuviRed window titled Removing YuviRed Lite, then Removal Complete with "YuviRed Lite was removed from this computer", "Your data, settings and logs were kept in C:\ProgramData\YuviRed. Installing YuviRed Lite again on this computer uses them." and "Computers you added keep their agent. Remove it on each computer with Uninstall-YuviRed-Agent.cmd, or from Settings, Apps." A removal that needs a restart adds "Windows needs to restart to finish removing YuviRed Lite."

  4. Restart the computer if the window asks you to.

To remove it without a window: YuviRed-Lite.exe /uninstall /quiet (the ACCEPT_EULA rule applies to unattended installs; whether a quiet removal is refused without it was not verified).

How to confirm.

  1. In Services, there is no YuviRed, YuviRedPostgres or YuviRedAgent.
  2. C:\Program Files\YuviRed is gone.
  3. https://127.0.0.1:8443 no longer answers.

Common problems.

ProblemWhat to do
"Removal Failed" or a message about restartingRestart, then run the uninstall again. Before you restart, run the support collector if you want support to look at it (Collecting diagnostics): a restart removes the state that explains the failure.
A service is "marked for deletion"Restart the computer. Windows removes it then.
The Apps list shows nothingDo not delete folders by hand. Contact support@yuvired.com.

Rollback. Install the same version (or a newer one) again with YuviRed-Lite.exe. If C:\ProgramData\YuviRed was kept, the new install finds the identity, secrets and database and continues: accounts, computers and the installation ID are the same, and the first-run setup page does not open again.


2. What is removed and what stays

Removed by a normal uninstall (in this order: firewall rule, stop YuviRed, stop YuviRedPostgres, unregister the database service, delete the YuviRed service, remove the AI tool hooks, remove the version folders, the server agent's code copy, its launcher and the staging folder; the YuviRedAgent service and the browser registrations are removed first of all)

  • The three services: YuviRed, YuviRedPostgres and YuviRedAgent.
  • The programs in C:\Program Files\YuviRed, including the version folders of the application, the server agent's code copy (agent-code) and launcher, and the support collector.
  • The Windows Firewall rule YuviRed Server (TCP 8443), if you had turned on network mode.
  • The browser connector registrations (the registry entries that let the extension talk to the agent) and the Event Viewer sources YuviRed and YuviRedAgent.
  • The hooks YuviRed added to other AI tools' managed settings (Claude Code, Codex, Gemini CLI, Cursor, Copilot CLI, Windsurf), where a connector had been turned on.

Nothing is sent to YuviRed or to your computers: the removal does not notify anyone.

Stays after a normal uninstall

WhatWhereWhy it matters
The data folderC:\ProgramData\YuviRedThe database (computers, alerts, accounts, history), the generated secrets and encryption key, the HTTPS certificate and private key, the server's identity and installation ID, and the logs. All of it is readable by anyone who can open the folder as an administrator, and most of it is not encrypted.
The server agent's logC:\ProgramData\SyntinelRed\logsThe folder name is the product's earlier name; it will change in a later release.
Windows' Visual C++ runtimeWindowsOther programs may use it.
Windows service profilesC:\Windows\ServiceProfilesWindows creates a profile for each service account and may leave it (not verified). It holds no YuviRed data.
The browser extensionIn each browserRemove it in chrome://extensions or edge://extensions.
The agents on other computersEvery computer you addedSee section 4.
Copies you madeAnywhereYuviRed knows nothing about them.

The installer never deletes C:\ProgramData\YuviRed. Logs are kept even after a purge (section 3).


3. Erase the data (the purge option)

Purpose. Remove the server's data as well as its programs: when you retire a server, return a computer, or must meet a deletion duty.

What it is. A command-line option, uninstall --purge, that you run by hand from an administrator PowerShell. The installer never uses it, and the Apps page has no checkbox for it. It runs the whole removal plan of section 2 (it stops and deletes the three services, removes the firewall rule, the version folders and the browser registrations) and then erases the data.

What it erases.

  • The identity files (appliance.json, the private key file appliance_private.dpapi, .key or .tpm, entitlement_lease.json and the .provisioned-ok marker) are **overwritten with random bytes and then deleted**.
  • The folders identity, config (generated secrets, encryption key, certificate and key), pg (the database), backups, scratch and status are removed. Those are removed, not overwritten: on a solid-state drive deletion does not guarantee the old data cannot be recovered. For that, use full-disk encryption on the server from the start, and erase the whole drive when you retire it.

What it does not erase.

  • C:\ProgramData\YuviRed\logs. Logs are kept.
  • The server agent's folder C:\ProgramData\YuviRed\agent (its settings, state and **its enrollment credential**, a secret), the file C:\ProgramData\YuviRed\update.journal, and the folder C:\ProgramData\YuviRed itself.
  • C:\ProgramData\SyntinelRed (the server agent's log; the earlier name, see section 2).
  • Any backup, copy of the data folder, export or report file you or anyone else made, anywhere. The purge cannot see them.
  • Anything the agents already stored on your other computers.

If you need those too, delete them yourself afterwards (carefully: agent and logs first, then the folders) and empty the Recycle Bin.

Prerequisites.

  • An administrator PowerShell.
  • You have decided you do not need the data. This cannot be undone.
  • The server is installed. The command is part of the installed programs, and the normal uninstall removes them, so the purge has to be run before the normal uninstall in section 1. **YuviRed has verified this command only from its code and its tests, not by running it after a normal uninstall or on a real customer server.** If you purge first, check afterwards that Installed apps still lists YuviRed Lite and remove it as in section 1.

Steps.

  1. Open PowerShell as administrator.
  2. Run the purge command (nothing is on PATH; both files are named in full):

    & "C:\Program Files\YuviRed\runtime\python.exe" "C:\Program Files\YuviRed\runtime\yuvired_service.py" uninstall --purge

    You should see: a line "browser host removed: ..." and then one line uninstall steps: listing the steps that ran, in this order: `remove_firewall_rule, stop_yuvired, stop_postgres, unregister_postgres, delete_yuvired_service, remove_ai_tool_connectors, remove_versions, remove_agent_code, remove_agent_launcher, remove_staging, erase_identity, remove_data, remove_bytecode_caches`. A step that failed in part carries "(failed: ...)" with the error name, for example remove_data (failed: PermissionError); the later steps still run.

  3. Remove the program as in section 1 if you have not. (After the purge the services are already gone; Installed apps still lists YuviRed Lite until you remove it.)
  4. Delete any folder named above that you want gone.

How to confirm. C:\ProgramData\YuviRed holds at most agent, logs and update.journal. The folders pg, config, identity and status are gone.

Common problems.

ProblemWhat to do
A step reads "(failed: PermissionError)"A file was still open (a service still stopping, an antivirus scan). Check in Services that YuviRedAgent, YuviRed and YuviRedPostgres are stopped or gone, then run the command again.
A folder is still there afterwardsRestart the computer and run the command again, or delete the folder by hand as administrator and empty the Recycle Bin.

Rollback. None. After a purge the server's history, accounts and encryption key are gone. A new install on the same computer starts from the beginning with a new installation ID and a new 7-day activation window, and needs a new activation (section 5).


4. Remove the agents from your other computers

Uninstalling the server does not notify the computers. Their agents keep running, keep trying to reach the server (and writing failures to their log), and keep their copy of the server's address and trust. Remove them yourself, ideally before you remove the server:

Purpose. Stop monitoring on a computer that you no longer watch.

On these computers the agent's Windows service is named SyntinelRedAgent (shown in Services as YuviRed Endpoint Agent) and its data and logs live in C:\ProgramData\SyntinelRed (the earlier name, see section 2). Only the server's own agent is named YuviRedAgent.

Steps, per computer.

  1. Sign in to the computer as an administrator.
  2. Remove the agent in one of two ways:
    • Open Settings, Apps, Installed apps, find YuviRed Agent, and Uninstall. Or:
    • If you still have the folder you unzipped from Add Computer, run Uninstall-YuviRed-Agent.cmd in it as administrator. It removes the agent, checks what is left, and deletes the download's own files from that folder: enrol.yuvired (the key to your server), YuviRed-Agent.msi, Install-YuviRed-Agent.cmd and README.txt.
  3. Remove the browser extension in chrome://extensions or edge://extensions (Remove), if it was loaded there.
  4. Delete any copy of the Add Computer zip and its enrol.yuvired file from that computer and from shared folders.

You should see: the agent is gone from Installed apps, there is no SyntinelRedAgent service, and C:\ProgramData\SyntinelRed is gone.

If the server is still running, also remove the computer from the console first: Endpoints, the red bin icon (Remove endpoint), which frees the seat and deletes that computer's data (Administration, section 7.4).

Common problems.

ProblemWhat to do
The Add Computer folder is goneUse Installed apps.
Uninstall is refusedRun it as administrator.
Settings says the uninstall worked, but something is leftAn uninstall from Settings does not report what its cleanup could not remove. Check that the SyntinelRedAgent service and C:\ProgramData\SyntinelRed are gone. Uninstall-YuviRed-Agent.cmd checks for you and names what is left.

Rollback. Add the computer again with a new Add Computer download from a server.


5. What happens to your license

  • The license is bound to the installation ID of the server it was activated on. The installation ID is kept in C:\ProgramData\YuviRed\identity\appliance.json and in the database. If you kept the data folder and reinstall on the same computer and the same Windows installation, the server keeps its ID and stays activated.
  • If you purged, or deleted the data folder, a new install has a new installation ID and is not activated. It gets a new 7-day activation window.
  • A license is not moved by you. To use your license, or your company's Lite allowance, on another server, contact support@yuvired.com and give the old and new installation IDs. For Lite, a company may have 2 servers, counted by installation ID over time: a replacement server uses one. Pro and Enterprise licenses are handled by YuviRed.
  • Uninstalling does not tell YuviRed. The server stops sending its daily check-in. YuviRed sees a server that is not reporting. Nothing is revoked or refunded by uninstalling.

To confirm the old server is gone from your records, write to support@yuvired.com. There is no screen on which you remove a server from your company's allowance.