Skip to content

Commit

Permalink
linux uninstall and docs updates (#1516)
Browse files Browse the repository at this point in the history
  • Loading branch information
zackattack01 authored Dec 21, 2023
1 parent 0a85614 commit b41dde2
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 2 deletions.
1 change: 1 addition & 0 deletions cmd/launcher/uninstall_linux.go
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ func removeLauncher(ctx context.Context, identifier string) error {
pathsToRemove := []string{
fmt.Sprintf("/var/%s", identifier),
fmt.Sprintf("/etc/%s", identifier),
fmt.Sprintf("/usr/local/%s", identifier),
}

// Now remove the paths used for launcher/osquery binaries and app data
Expand Down
16 changes: 14 additions & 2 deletions docs/uninstalling.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,13 @@
# Uninstalling Osquery Launcher

> [!NOTE]
> [!NOTE]
> This documents are for an open source launcher install. If you're looking for official instructions on how to uninstall
> Kolide Agent, try https://www.kolide.com/docs/using-kolide/agent/removal-instructions
> [!NOTE]
> All paths noted on this page are based off of the identifier used at the time of package creation.
> The paths listed here assume an identifier of `kolide`. If you use a different identifier you will
> need to update any paths accordingly
## Linux

Expand Down Expand Up @@ -33,7 +37,7 @@ To remove `launcher` and **remove** configuration files, run the following:
sudo dpkg --purge launcher
```

`dpkg --purge` will not delete directories which are not empty. As a result you might see a warning which looks like:
`dpkg --purge` will not delete directories which are not empty. As a result you might see a warning which looks like:

```
dpkg: warning: while removing launcher, directory '/usr/local/kolide/bin' not empty so not removed
Expand All @@ -42,6 +46,12 @@ dpkg: warning: while removing launcher, directory '/var/kolide/launcher.example.

Based on the configurations used when the Launcher package was created, the specific paths printed may look slightly different. In any case, these left over directories mentioned in the `dpkg` warning can be removed with `sudo rm -rf`.

Directories:

- `/usr/local/kolide`
- `/var/kolide`
- `/etc/kolide`

## macOS

### Launcher (`kolide-osquery-launcher.pkg`)
Expand All @@ -50,6 +60,7 @@ Directories:

- `/usr/local/kolide`
- `/var/kolide`
- `/var/log/kolide`
- `/etc/kolide`

Files:
Expand All @@ -63,4 +74,5 @@ sudo rm /Library/LaunchDaemons/com.kolide.launcher.plist
sudo rm -r /usr/local/kolide
sudo rm -r /var/kolide
sudo rm -r /etc/kolide
sudo pkgutil --forget com.kolide.launcher
```

0 comments on commit b41dde2

Please sign in to comment.