Skip to content

Add Linux, Windows, DEB, and RPM standalone agent upgrade commands #4187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bmorelli25 merged 9 commits into from
Dec 10, 2025
+46 −5
Merged

Add Linux, Windows, DEB, and RPM standalone agent upgrade commands #4187

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
07d59ad
Initial plan
Copilot Dec 2, 2025
d080f46
Add Linux, Windows, DEB, and RPM standalone agent upgrade commands
Copilot Dec 2, 2025
b5f8bb1
Merge branch 'main' into copilot/add-upgrade-commands-linux-windows
bmorelli25 Dec 3, 2025
cbc2cbb
Apply suggestions from code review
bmorelli25 Dec 9, 2025
75854c4
Update upgrade instructions for Elastic Agent version
bmorelli25 Dec 10, 2025
7511cb7
Simplify upgrade instructions for Elastic Agent
bmorelli25 Dec 10, 2025
c60d7aa
Fix typo in Windows upgrade instructions
bmorelli25 Dec 10, 2025
2995dca
Fix grammatical error in upgrade instructions
bmorelli25 Dec 10, 2025
d9662a6
Merge branch 'main' into copilot/add-upgrade-commands-linux-windows
bmorelli25 Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 46 additions & 5 deletions reference/fleet/upgrade-standalone.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,54 @@
1. Make sure the `elastic-agent` service is running.
2. From the directory where {{agent}} is installed, run the `upgrade` command to upgrade to a new version. Not sure where the agent is installed? Refer to [Installation layout](/reference/fleet/installation-layout.md).
Copy link
Member

@bmorelli25 bmorelli25 Dec 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vishaangelova you're right that this step already tells folks to move to the right directory. I've simplified the instructions below. Thanks!


For example, on macOS, to upgrade the agent from version 8.8.0 to 8.8.1, you would run:
For example, to upgrade the agent from version 9.1.0 to 9.1.1, you would run:

:::::{tab-set}

::::{tab-item} macOS

```shell
sudo elastic-agent upgrade 9.1.1
```

::::

::::{tab-item} Linux

```shell
sudo elastic-agent upgrade 9.1.1
```

::::

::::{tab-item} Windows

As an Administrator, run:

```shell
cd /Library/Elastic/Agent/
sudo elastic-agent upgrade 8.8.1
.\elastic-agent.exe upgrade 9.1.1
```

::::

::::{tab-item} DEB

Check notice on line 46 in reference/fleet/upgrade-standalone.md

View workflow job for this annotation

GitHub Actions / vale 

Elastic.Acronyms: 'DEB' has no definition.

```shell
sudo elastic-agent upgrade 9.1.1
```

::::

::::{tab-item} RPM

Check notice on line 54 in reference/fleet/upgrade-standalone.md

View workflow job for this annotation

GitHub Actions / vale 

Elastic.Acronyms: 'RPM' has no definition.

```shell
sudo elastic-agent upgrade 9.1.1
```

::::

:::::


This command upgrades the binary. Your agent policy should continue to work, but you might need to upgrade it to use new features and capabilities.

Expand Down Expand Up @@ -53,7 +94,7 @@
Example:

```yaml
./elastic-agent upgrade 8.8.0 --skip-verify
./elastic-agent upgrade 9.1.0 --skip-verify
```


Expand All @@ -63,7 +104,7 @@
Example:

```yaml
./elastic-agent upgrade 8.8.0 --pgp-path /home/elastic-agent/GPG-KEY-elasticsearch
./elastic-agent upgrade 9.1.0 --pgp-path /home/elastic-agent/GPG-KEY-elasticsearch
```


Expand Down
Loading