From fb2a6190a6defd2824005e2fce00a4004c8c1aaf Mon Sep 17 00:00:00 2001 From: Carl Tashian Date: Tue, 9 Jun 2026 20:37:23 -0700 Subject: [PATCH] Update Linux agent install docs for step-agent package rename The manual install instructions still referenced the old step-agent-plugin package, which the repos serve at a stale 0.63.1 that fails to run on headless systems (missing libwebkit2gtk). The agent is now packaged as step-agent (0.67.3), matching the quick-install script. Validated end-to-end in Fedora, Rocky 9, Debian stable, and Ubuntu 24.04 containers, including the systemd start flow. - Rename step-agent-plugin to step-agent in install, version check, register, and uninstall commands - Update sample version output to the current format - Drop a no-op DEBIAN_FRONTEND line from the Ubuntu steps - Enable step-agent-restart.path alongside the service, matching the quick-install script Co-Authored-By: Claude Fable 5 --- platform/smallstep-agent.mdx | 42 ++++++++++++++++++------------------ 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/platform/smallstep-agent.mdx b/platform/smallstep-agent.mdx index 6fd24745..81163c29 100644 --- a/platform/smallstep-agent.mdx +++ b/platform/smallstep-agent.mdx @@ -1,5 +1,5 @@ --- -updated_at: May 21, 2026 +updated_at: June 9, 2026 title: Install the Smallstep Agent html_title: Install the Smallstep Agent on macOS, Windows, and Linux description: Install, configure, and deploy the Smallstep Agent on macOS, Windows, and Linux endpoints. Includes manual install, MDM integration, system requirements, and network endpoints. @@ -141,20 +141,20 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s 2. Install the Smallstep agent: ```bash - sudo dnf makecache && sudo dnf install -y step-agent-plugin + sudo dnf makecache && sudo dnf install -y step-agent ``` 3. Check that it was installed correctly: ```bash - step-agent-plugin version + step-agent version ``` Output: ```bash - πŸš€ step-agent-plugin/0.38.0 (linux/amd64) - Release Date: 2024-10-10T14:55:48Z + step-agent/0.67.3 (linux/amd64) + Release Date: 2026-05-19 17:16 UTC ``` @@ -177,20 +177,20 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s 2. Install the Smallstep agent: ```bash - sudo dnf makecache && sudo dnf install -y step-agent-plugin + sudo dnf makecache && sudo dnf install -y step-agent ``` 3. Check that it was installed correctly: ```bash - step-agent-plugin version + step-agent version ``` Output: ```bash - πŸš€ step-agent-plugin/0.38.0 (linux/amd64) - Release Date: 2024-10-10T14:55:48Z + step-agent/0.67.3 (linux/amd64) + Release Date: 2026-05-19 17:16 UTC ``` @@ -218,20 +218,20 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s 3. Install the Smallstep agent: ```bash - sudo apt-get update && sudo apt-get -y install step-agent-plugin + sudo apt-get update && sudo apt-get -y install step-agent ``` 4. Check that it was installed correctly: ```bash - step-agent-plugin version + step-agent version ``` Output: ```bash - πŸš€ step-agent-plugin/0.38.0 (linux/amd64) - Release Date: 2024-10-10T14:55:48Z + step-agent/0.67.3 (linux/amd64) + Release Date: 2026-05-19 17:16 UTC ``` @@ -240,7 +240,6 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s 1. In the Terminal, install dependencies: ```bash - DEBIAN_FRONTEND=noninteractive sudo apt-get update && sudo apt-get install -y --no-install-recommends curl gpg ca-certificates ``` @@ -260,20 +259,20 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s 3. Install the Smallstep agent ```bash - sudo apt-get update && sudo apt-get -y install step-agent-plugin openssl-tpm2-engine + sudo apt-get update && sudo apt-get -y install step-agent openssl-tpm2-engine ``` 4. Check that it was installed correctly ```bash - step-agent-plugin version + step-agent version ``` Output: ```bash - πŸš€ step-agent-plugin/0.38.0 (linux/amd64) - Release Date: 2024-10-10T14:55:48Z + step-agent/0.67.3 (linux/amd64) + Release Date: 2026-05-19 17:16 UTC ``` @@ -284,7 +283,7 @@ curl -fsSL https://packages.smallstep.com/scripts/smallstep-agent-install.sh | s Users can configure the agent and register their Linux device with your Smallstep team by running: ```bash -sudo step-agent-plugin register [team name] +sudo step-agent register [team name] ``` By default, self-registration is not trust-on-first-use (TOFU). @@ -317,6 +316,7 @@ Finally, enable and start the agent: ```bash sudo systemctl daemon-reload sudo systemctl enable --now step-agent +sudo systemctl enable --now step-agent-restart.path ``` If you get any errors, check the agent’s status: @@ -363,12 +363,12 @@ To uninstall the Smallstep Agent from a Linux system: **For Fedora/RHEL/Enterprise Linux:** ```bash - sudo dnf remove step-agent-plugin + sudo dnf remove step-agent ``` **For Debian/Ubuntu:** ```bash - sudo apt-get remove step-agent-plugin + sudo apt-get remove step-agent ``` 2. Optionally, remove configuration and certificate files: