Uninstalling FlightStack Agent | FlightStack

Uninstalling FlightStack

This guide covers how to completely remove the FlightStack agent and CLI from your system.

Quick Uninstall

For a complete removal, run these commands in order:

macOS

# 1. Stop and remove the startup service
flightstack agent uninstall

# 2. Unregister the agent from FlightStack
flightstack agent unregister

# 3. Remove binaries
sudo rm /usr/local/bin/flightstack-agent
sudo rm /usr/local/bin/flightstack

# 4. Remove configuration and logs
rm -rf ~/.flightstack

Linux

# 1. Stop and remove the startup service
flightstack agent uninstall

# 2. Unregister the agent from FlightStack
flightstack agent unregister

# 3. Remove binaries
sudo rm /usr/local/bin/flightstack-agent
sudo rm /usr/local/bin/flightstack

# 4. Remove configuration and logs
rm -rf ~/.flightstack

Windows

# 1. Stop and remove the startup service
flightstack agent uninstall

# 2. Unregister the agent from FlightStack
flightstack agent unregister

# 3. Remove binaries (adjust path if installed elsewhere)
Remove-Item "C:\Program Files\FlightStack\flightstack-agent.exe" -Force
Remove-Item "C:\Program Files\FlightStack\flightstack.exe" -Force

# 4. Remove configuration and logs
Remove-Item "$env:USERPROFILE\.flightstack" -Recurse -Force

Step-by-Step Uninstallation

1. Stop the Running Agent

   If the agent is currently running:

   flightstack agent stop

2. Remove Startup Service

   Remove the auto-start configuration:

   flightstack agent uninstall

   This removes:

   • macOS: ~/Library/LaunchAgents/com.flightstack.agent.plist
   • Linux: ~/.config/systemd/user/flightstack-agent.service
   • Windows: FlightStackAgent scheduled task

3. Unregister the Agent

   Remove the agent registration from FlightStack servers:

   flightstack agent unregister

   Tip

   You can also delete the agent from the FlightStack web app under Build Agents.

4. Remove Binaries

   Delete the executable files:

   macOS / Linux

   # Find where binaries are installed
   which flightstack-agent
   which flightstack
   
   # Remove them (common locations)
   sudo rm /usr/local/bin/flightstack-agent
   sudo rm /usr/local/bin/flightstack
   
   # If installed via Homebrew
   brew uninstall flightstack

   Windows

   # Find installation location
   Get-Command flightstack-agent | Select-Object Source
   Get-Command flightstack | Select-Object Source
   
   # Remove binaries
   Remove-Item "<path-to-binary>" -Force

5. Remove Configuration Directory

   Delete all FlightStack configuration, credentials, and logs:

   macOS / Linux

   rm -rf ~/.flightstack

   Windows

   Remove-Item "$env:USERPROFILE\.flightstack" -Recurse -Force

   Caution

   This removes your authentication tokens. You’ll need to log in again if you reinstall.

What Gets Removed

Configuration Directory (~/.flightstack/)

File	Description
config.json	Agent registration and token
config.<profile>.json	Profile-specific agent configs
cli_config.json	CLI authentication token
agent.log	Agent output logs
agent.error.log	Agent error logs

Service Files

Platform	Location
macOS	~/Library/LaunchAgents/com.flightstack.agent.plist
Linux	~/.config/systemd/user/flightstack-agent.service
Windows	Scheduled Task: FlightStackAgent

Binaries

Binary	Common Locations
flightstack-agent	/usr/local/bin/, ~/.local/bin/, or custom path
flightstack	/usr/local/bin/, ~/.local/bin/, or custom path

Manual Cleanup

If the standard uninstall doesn’t work, you can manually remove everything:

macOS

# Stop launchd service if running
launchctl stop com.flightstack.agent 2>/dev/null
launchctl unload ~/Library/LaunchAgents/com.flightstack.agent.plist 2>/dev/null

# Remove service file
rm -f ~/Library/LaunchAgents/com.flightstack.agent.plist

# Remove binaries
sudo rm -f /usr/local/bin/flightstack-agent
sudo rm -f /usr/local/bin/flightstack

# Remove all config and logs
rm -rf ~/.flightstack

# Remove any cached credentials (if using Keychain)
security delete-generic-password -s "flightstack" 2>/dev/null

Linux

# Stop and disable systemd service
systemctl --user stop flightstack-agent 2>/dev/null
systemctl --user disable flightstack-agent 2>/dev/null

# Remove service file
rm -f ~/.config/systemd/user/flightstack-agent.service
systemctl --user daemon-reload

# Remove binaries
sudo rm -f /usr/local/bin/flightstack-agent
sudo rm -f /usr/local/bin/flightstack

# Remove all config and logs
rm -rf ~/.flightstack

Windows

# Stop and remove scheduled task
schtasks /end /tn FlightStackAgent 2>$null
schtasks /delete /tn FlightStackAgent /f 2>$null

# Remove binaries
Remove-Item "C:\Program Files\FlightStack" -Recurse -Force -ErrorAction SilentlyContinue

# Remove from PATH if added
# (Manual step - edit Environment Variables)

# Remove all config and logs
Remove-Item "$env:USERPROFILE\.flightstack" -Recurse -Force -ErrorAction SilentlyContinue

Verify Complete Removal

After uninstalling, verify everything is removed:

macOS / Linux

# Check binaries are gone
which flightstack-agent  # Should return nothing
which flightstack        # Should return nothing

# Check config is gone
ls ~/.flightstack        # Should say "No such file or directory"

# Check service is gone (macOS)
launchctl list | grep flightstack  # Should return nothing

# Check service is gone (Linux)
systemctl --user status flightstack-agent  # Should say "not found"

Windows

# Check binaries are gone
Get-Command flightstack-agent -ErrorAction SilentlyContinue
Get-Command flightstack -ErrorAction SilentlyContinue

# Check config is gone
Test-Path "$env:USERPROFILE\.flightstack"  # Should return False

# Check scheduled task is gone
schtasks /query /tn FlightStackAgent  # Should say "not found"

Reinstalling

If you want to reinstall FlightStack later:

1. Download the latest version from Installation Guide
2. Run flightstack login to authenticate
3. Run flightstack agent register to register your machine
4. Run flightstack agent start to start the agent

Troubleshooting

”Command not found” during uninstall

If you’ve already removed the binaries, use manual cleanup steps above.

Agent still shows in FlightStack app

Delete it manually:

1. Go to FlightStack web app
2. Navigate to Build Agents
3. Click on the agent
4. Click Delete Agent

Service still running after uninstall

macOS

# Force stop and unload
launchctl stop com.flightstack.agent
launchctl unload ~/Library/LaunchAgents/com.flightstack.agent.plist
launchctl remove com.flightstack.agent

Linux

# Force stop
systemctl --user stop flightstack-agent
systemctl --user disable flightstack-agent
systemctl --user daemon-reload

Windows

# Force end task
Stop-Process -Name "flightstack-agent" -Force -ErrorAction SilentlyContinue
schtasks /delete /tn FlightStackAgent /f

Permission denied errors

Run removal commands with elevated privileges:

macOS / Linux

sudo rm /usr/local/bin/flightstack-agent
sudo rm /usr/local/bin/flightstack

Windows

Run PowerShell as Administrator, then execute the removal commands.