From 3877e0c3485d6148b018980c1cb31cbf62fcbc63 Mon Sep 17 00:00:00 2001 From: Josh Rotenberg Date: Tue, 6 Oct 2026 14:11:14 -0700 Subject: [PATCH 1/3] chore: start release installation docs repair (#1183) From fc69f83bb1cde7931b8a85df5cac362e8f92a137 Mon Sep 17 00:00:00 2001 From: Josh Rotenberg Date: Tue, 6 Oct 2026 14:13:33 -0700 Subject: [PATCH 2/3] docs: repair application-specific release installation recipes (#1183) --- docs/docs/getting-started/installation.md | 41 +++++++++++++++-------- docs/docs/mcp/getting-started.md | 15 +++++++-- 2 files changed, 39 insertions(+), 17 deletions(-) diff --git a/docs/docs/getting-started/installation.md b/docs/docs/getting-started/installation.md index 28850f41..425b707b 100644 --- a/docs/docs/getting-started/installation.md +++ b/docs/docs/getting-started/installation.md @@ -48,39 +48,52 @@ cargo install redisctl --features secure-storage ## Binary Downloads -Download pre-built binaries from [GitHub Releases](https://github.com/redis/redisctl/releases/latest). +The examples below install **redisctl 0.12.1** from its +[CLI release](https://github.com/redis/redisctl/releases/tag/redisctl-v0.12.1). +For another version, choose its `redisctl-v` release and matching assets. +Avoid the repository-wide "latest" link: this workspace releases the CLI and MCP +server separately, so "latest" may point to the other application. + +Archives contain a top-level platform directory. These commands extract it into +a temporary directory before installing the binary. === "Linux (x86_64)" ``` bash - curl -L https://github.com/redis/redisctl/releases/latest/download/redisctl-x86_64-unknown-linux-gnu.tar.xz | tar xJ - sudo mv redisctl /usr/local/bin/ + install_dir="$(mktemp -d)" + curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-unknown-linux-gnu.tar.xz -o "$install_dir/redisctl.tar.xz" + tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir" + sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl ``` === "Linux (ARM64)" - ``` bash - curl -L https://github.com/redis/redisctl/releases/latest/download/redisctl-aarch64-unknown-linux-gnu.tar.xz | tar xJ - sudo mv redisctl /usr/local/bin/ - ``` + Version 0.12.1 does not provide a pre-built Linux ARM64 archive. Build from + source with [Cargo](#cargo-from-source), or use the Linux ARM64 image described + in the [Docker guide](docker.md). === "macOS (Intel)" ``` bash - curl -L https://github.com/redis/redisctl/releases/latest/download/redisctl-x86_64-apple-darwin.tar.xz | tar xJ - sudo mv redisctl /usr/local/bin/ + install_dir="$(mktemp -d)" + curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-apple-darwin.tar.xz -o "$install_dir/redisctl.tar.xz" + tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir" + sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl ``` === "macOS (Apple Silicon)" ``` bash - curl -L https://github.com/redis/redisctl/releases/latest/download/redisctl-aarch64-apple-darwin.tar.xz | tar xJ - sudo mv redisctl /usr/local/bin/ + install_dir="$(mktemp -d)" + curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-aarch64-apple-darwin.tar.xz -o "$install_dir/redisctl.tar.xz" + tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir" + sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl ``` === "Windows" - Download the `.zip` file from releases and extract to a directory in your PATH. + Download the [Windows x86_64 archive](https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-pc-windows-msvc.zip), + extract it, and add the directory containing `redisctl.exe` to your PATH. ## Verify Installation @@ -88,10 +101,10 @@ Download pre-built binaries from [GitHub Releases](https://github.com/redis/redi redisctl --version ``` -Expected output: +For the 0.12.1 binary download examples above, the expected output is: ``` -redisctl 0.11.1 +redisctl 0.12.1 ``` ## Shell Completions diff --git a/docs/docs/mcp/getting-started.md b/docs/docs/mcp/getting-started.md index aeca29fc..f70c80a6 100644 --- a/docs/docs/mcp/getting-started.md +++ b/docs/docs/mcp/getting-started.md @@ -8,14 +8,20 @@ The MCP server is a separate binary called `redisctl-mcp`. Install it using one ### Installer Script (Recommended) +These examples install **redisctl-mcp 0.12.1** from its +[MCP release](https://github.com/redis/redisctl/releases/tag/redisctl-mcp-v0.12.1). +For another version, choose its `redisctl-mcp-v` release and matching +installer. Avoid the repository-wide "latest" link: the CLI and MCP server are +released separately, so "latest" may contain only CLI assets. + ```bash # macOS / Linux -curl --proto '=https' --tlsv1.2 -LsSf https://github.com/redis/redisctl/releases/latest/download/redisctl-mcp-installer.sh | sh +curl --proto '=https' --tlsv1.2 -LsSf https://github.com/redis/redisctl/releases/download/redisctl-mcp-v0.12.1/redisctl-mcp-installer.sh | sh ``` ```powershell # Windows -powershell -ExecutionPolicy Bypass -c "irm https://github.com/redis/redisctl/releases/latest/download/redisctl-mcp-installer.ps1 | iex" +powershell -ExecutionPolicy Bypass -c "irm https://github.com/redis/redisctl/releases/download/redisctl-mcp-v0.12.1/redisctl-mcp-installer.ps1 | iex" ``` ### Cargo @@ -26,7 +32,10 @@ cargo install redisctl-mcp ### Binary Downloads -Download pre-built binaries from [GitHub Releases](https://github.com/redis/redisctl/releases/latest). +Download pre-built binaries from the +[MCP release](https://github.com/redis/redisctl/releases/tag/redisctl-mcp-v0.12.1), +not the CLI release. Use the archive for your platform and add the extracted +directory containing `redisctl-mcp` (or `redisctl-mcp.exe` on Windows) to your PATH. ### Docker (Zero-Install) From 19376e6e70813a3a4e348b7151d7859026fe4748 Mon Sep 17 00:00:00 2001 From: Josh Rotenberg Date: Tue, 6 Oct 2026 14:14:09 -0700 Subject: [PATCH 3/3] docs: clarify ARM64 container alternative --- docs/docs/getting-started/installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docs/getting-started/installation.md b/docs/docs/getting-started/installation.md index 425b707b..6ca2f8e5 100644 --- a/docs/docs/getting-started/installation.md +++ b/docs/docs/getting-started/installation.md @@ -69,8 +69,8 @@ a temporary directory before installing the binary. === "Linux (ARM64)" Version 0.12.1 does not provide a pre-built Linux ARM64 archive. Build from - source with [Cargo](#cargo-from-source), or use the Linux ARM64 image described - in the [Docker guide](docker.md). + source with [Cargo](#cargo-from-source), or see the [Docker guide](docker.md) + for container-based installation. === "macOS (Intel)"