Skip to main content

Uninstall Vineforce Teams | Linux

Uninstall Vineforce Teams on Linux​

Linux  |  Complete Removal

This guide covers removing Vineforce Teams with a single script. It force-stops the app if it's currently running, then purges the installed .deb package — cleaning up the application, the GNOME Shell extension, desktop entries, the CLI alias, and the autostart entry.

One command handles complete removal:

chmod +x ~/Downloads/uninstall-vineforce-teams.sh && ~/Downloads/uninstall-vineforce-teams.sh

You'll be prompted for your system (sudo) password partway through, since removing an installed package requires elevated privileges.

info

Why a script instead of just apt purge? sudo apt purge vineforce-teams alone works too, but this script also forcefully stops the app first if it's currently running — sending SIGTERM, waiting up to 5 seconds, then escalating to SIGKILL if needed — so nothing lingers in the background after removal, and it verifies the result afterward.

Prerequisites for Linux uninstall​

RequirementDetails
Operating SystemDebian/Ubuntu-based Linux
Existing InstallationVineforce Teams must be installed via the .deb package
Privilegessudo access required (you'll be prompted for your password)
warning

Important This completely removes Vineforce Teams and its associated files. The .NET 10 runtime it may have installed is left in place, since other apps might depend on it — see the note at the end of this guide if you want that removed too.

Step 1: Download the Uninstall Script​

Download uninstall-vineforce-teams.sh

Save it to your Linux machine — for example, to your Downloads folder:

~/Downloads/uninstall-vineforce-teams.sh

Step 2: Run the Uninstall Script​

Make it executable and run it in one command:

chmod +x ~/Downloads/uninstall-vineforce-teams.sh && ~/Downloads/uninstall-vineforce-teams.sh

The script runs automatically and prompts for your sudo password when it needs to purge the package. You'll see output like:

=== Stopping Vineforce Teams if it's running ===
Found a running instance — sending SIGTERM...
Process exited cleanly.

=== Purging the package ===
[sudo] password for you:
Removing vineforce-teams (1.0.0) ...
Purging configuration files for vineforce-teams (1.0.0) ...

=== Verifying removal ===
No Vineforce Teams process is running.
Application folder removed.

=== UNINSTALL COMPLETE ===

What the Script Does (Automatic)​

Step A: Stop the Running Process​

The script checks for any running Vineforce Teams process:

  • If found → sends SIGTERM (a polite request to exit), waits up to 5 seconds
  • If still running after 5 seconds → escalates to SIGKILL (force-terminate), so the app never survives removal
  • If not found → skips straight to purging

Step B: Purge the Package​

The script checks whether vineforce-teams is actually installed via dpkg, and if so runs:

sudo apt purge -y vineforce-teams

This triggers the package's own prerm/postrm scripts, which:

  • Remove /opt/vineforce-teams/ (the application files)
  • Remove the window-calls-extended GNOME Shell extension
  • Remove the desktop menu entry, autostart entry, and /usr/bin/vineforce-teams CLI alias
  • Refresh the desktop and icon caches

If the package isn't installed, the script tells you and skips this step rather than failing.

Step C: Verify Removal​

The script finishes by checking:

  • Whether any process matching the app is still running
  • Whether /opt/vineforce-teams still exists

If either check fails, it prints a warning so you know exactly what to check manually.

Troubleshooting​

ProblemSolution
Script permission deniedRun chmod +x uninstall-vineforce-teams.sh before executing.
Prompted for password but nothing happensMake sure you're typing your password correctly — terminals don't show characters as you type sudo passwords, which is normal.
"WARNING: a process is still running" after script finishesCheck manually with ps aux | grep -i vineforce and kill it directly with kill -9 [PID] if needed.
"WARNING: /opt/vineforce-teams still exists"The purge may have failed partway. Run sudo apt purge vineforce-teams manually and check for errors.
"Package is not currently installed via apt/dpkg"Vineforce Teams isn't installed as a .deb on this machine — nothing to remove.
Script fails mid-executionSafe to re-run — it checks current state before acting at each step.

Manual Removal (Alternative Method)​

If the script fails or you prefer to do it by hand:

1. Stop the Running Process​

pkill -TERM -f "Vineforce.Admin.Desktop.Avalonia"
sleep 5
pkill -KILL -f "Vineforce.Admin.Desktop.Avalonia"

2. Purge the Package​

sudo apt purge vineforce-teams

3. Verify Removal​

ps aux | grep -i "Vineforce"
ls /opt/vineforce-teams 2>&1

Best Practices​

tip
  • Back up important data before uninstalling if you need to preserve any local information
  • Use this script (or apt purge), not apt remove, for a truly clean uninstall that also cleans up the GNOME extension and caches
  • Reboot if necessary to ensure all processes are terminated and files are unlocked

Also Removing the .NET Runtime?​

The .NET 10 runtime installed to /opt/dotnet during setup is not removed by this script or by apt purge, since other applications on the machine might depend on it. If you're sure nothing else needs it:

sudo rm -rf /opt/dotnet /usr/local/bin/dotnet

What's Next?​

After successfully uninstalling Vineforce Teams, you can:

  • Reinstall the application using the Linux installation guide
  • Install on a different machine using the same process
  • Contact support if you experienced any issues during uninstallation

Returning to install Vineforce Teams? See our Linux installation guide.

Last updated on by taranum-vineforce