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\YuviRedfirst (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.
- Open Windows Settings, Apps, Installed apps (on Windows 10: Apps and Features).
- Find YuviRed Lite, click the three dots (or select it), and choose Uninstall, then confirm.
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."
- 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.
- In Services, there is no
YuviRed,YuviRedPostgresorYuviRedAgent. C:\Program Files\YuviRedis gone.https://127.0.0.1:8443no longer answers.
Common problems.
| Problem | What to do |
|---|---|
| "Removal Failed" or a message about restarting | Restart, 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 nothing | Do 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,YuviRedPostgresandYuviRedAgent. - 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
YuviRedandYuviRedAgent. - 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
| What | Where | Why it matters |
|---|---|---|
| The data folder | C:\ProgramData\YuviRed | The 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 log | C:\ProgramData\SyntinelRed\logs | The folder name is the product's earlier name; it will change in a later release. |
| Windows' Visual C++ runtime | Windows | Other programs may use it. |
| Windows service profiles | C:\Windows\ServiceProfiles | Windows creates a profile for each service account and may leave it (not verified). It holds no YuviRed data. |
| The browser extension | In each browser | Remove it in chrome://extensions or edge://extensions. |
| The agents on other computers | Every computer you added | See section 4. |
| Copies you made | Anywhere | YuviRed 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 fileappliance_private.dpapi,.keyor.tpm,entitlement_lease.jsonand the.provisioned-okmarker) are **overwritten with random bytes and then deleted**. - The folders
identity,config(generated secrets, encryption key, certificate and key),pg(the database),backups,scratchandstatusare 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 fileC:\ProgramData\YuviRed\update.journal, and the folderC:\ProgramData\YuviReditself. 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.
- Open PowerShell as administrator.
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 --purgeYou 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 exampleremove_data (failed: PermissionError); the later steps still run.- 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.)
- 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.
| Problem | What 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 afterwards | Restart 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.
- Sign in to the computer as an administrator.
- 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.cmdin 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.cmdandREADME.txt.
- Remove the browser extension in
chrome://extensionsoredge://extensions(Remove), if it was loaded there. - Delete any copy of the Add Computer zip and its
enrol.yuviredfile 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.
| Problem | What to do |
|---|---|
| The Add Computer folder is gone | Use Installed apps. |
| Uninstall is refused | Run it as administrator. |
| Settings says the uninstall worked, but something is left | An 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.jsonand 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.