From ede4075d9985adca83b3b5d794c385f70976d65b Mon Sep 17 00:00:00 2001 From: monty-sei Date: Mon, 17 Aug 2026 19:55:57 +1000 Subject: [PATCH] docs: cover linux/arm64 in the prebuilt seid install and upgrade steps The prebuilt binary tabs hardcode the amd64 tarball name and state that the builds are amd64 only. Once arm64 binaries are attached, an operator on Graviton or Ampere following these pages downloads a 404 or, worse, installs an amd64 binary that will not run. Derive the asset architecture from uname -m rather than substituting it directly. The asset token is arm64 while uname -m reports aarch64 on Linux, so a naive substitution works on amd64 by coincidence and fails everywhere else. An unrecognised architecture now stops the pipeline instead of building a filename that does not exist. Both update procedures in node-operators.mdx get the same treatment. They were easy to miss and leaving them would let arm64 operators install and then be unable to upgrade. --- evm/installing-seid-cli.mdx | 18 ++++++++++++------ node/index.mdx | 20 +++++++++++++------- node/node-operators.mdx | 14 ++++++++++++-- 3 files changed, 37 insertions(+), 15 deletions(-) diff --git a/evm/installing-seid-cli.mdx b/evm/installing-seid-cli.mdx index 5bf322c..da6e30f 100644 --- a/evm/installing-seid-cli.mdx +++ b/evm/installing-seid-cli.mdx @@ -22,12 +22,17 @@ To install `seid`, locate the version you wish to use on the [sei-chain releases - Each release attaches a statically linked `seid` build for `linux/amd64` with no - runtime dependencies: + Each release attaches statically linked `seid` builds for `linux/amd64` and + `linux/arm64` with no runtime dependencies: ```bash VERSION= # e.g. v6.6.1 — see the version table above - FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz # asset filenames omit the leading v + case "$(uname -m)" in + x86_64) ARCH=x86_64 ;; + aarch64|arm64) ARCH=arm64 ;; + *) echo "unsupported architecture: $(uname -m)" >&2; exit 1 ;; + esac + FILE=sei-chain_${VERSION#v}_linux_${ARCH}.tar.gz # asset filenames omit the leading v curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/${FILE} curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/checksums.txt @@ -39,9 +44,10 @@ To install `seid`, locate the version you wish to use on the [sei-chain releases ``` - Prebuilt binaries are attached from `v6.6.1` onward — for earlier versions, build - from source. They are `linux/amd64` only and omit hardware Ledger support. On - other architectures, or if you sign with a Ledger device, build from source. + Prebuilt binaries are attached from `v6.6.1` onward, and `linux/arm64` from + ``. For earlier versions, or other architectures, build from + source. They omit hardware Ledger support, so if you sign with a Ledger device, + build from source. diff --git a/node/index.mdx b/node/index.mdx index c698b90..28a1b9c 100644 --- a/node/index.mdx +++ b/node/index.mdx @@ -118,12 +118,18 @@ See the Network Versions table above for the current recommended version. - Each release attaches a statically linked `seid` build for `linux/amd64` with no - runtime dependencies: no Go toolchain and no shared libraries to install. + Each release attaches statically linked `seid` builds for `linux/amd64` and + `linux/arm64` with no runtime dependencies: no Go toolchain and no shared + libraries to install. ```bash VERSION= # e.g. v6.6.1 — see the Network Versions table above - FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz # asset filenames omit the leading v + case "$(uname -m)" in + x86_64) ARCH=x86_64 ;; + aarch64|arm64) ARCH=arm64 ;; + *) echo "unsupported architecture: $(uname -m)" >&2; exit 1 ;; + esac + FILE=sei-chain_${VERSION#v}_linux_${ARCH}.tar.gz # asset filenames omit the leading v curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/${FILE} curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/checksums.txt @@ -138,10 +144,10 @@ See the Network Versions table above for the current recommended version. ``` - Prebuilt binaries are attached from `v6.6.1` onward. For earlier versions, - build from source or use Docker. They are `linux/amd64` only and omit hardware - Ledger support. On other architectures, or if you sign with a Ledger device, - build from source or use Docker. + Prebuilt binaries are attached from `v6.6.1` onward, and `linux/arm64` from + ``. For earlier versions, or other architectures, build from + source or use Docker. They omit hardware Ledger support, so if you sign with a + Ledger device, build from source or use Docker. diff --git a/node/node-operators.mdx b/node/node-operators.mdx index eca9a8a..8280b90 100644 --- a/node/node-operators.mdx +++ b/node/node-operators.mdx @@ -1648,7 +1648,12 @@ For minor updates that are non-consensus-breaking: # Download and verify the new release binary VERSION= # the new release tag, e.g. v6.6.1 - FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz # asset filenames omit the leading v + case "$(uname -m)" in + x86_64) ARCH=x86_64 ;; + aarch64|arm64) ARCH=arm64 ;; + *) echo "unsupported architecture: $(uname -m)" >&2; exit 1 ;; + esac + FILE=sei-chain_${VERSION#v}_linux_${ARCH}.tar.gz # asset filenames omit the leading v curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/${FILE} curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/checksums.txt @@ -1693,7 +1698,12 @@ For major upgrades that introduce state-breaking changes: ```bash # After node halts VERSION= # the new release tag, e.g. v6.6.1 - FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz + case "$(uname -m)" in + x86_64) ARCH=x86_64 ;; + aarch64|arm64) ARCH=arm64 ;; + *) echo "unsupported architecture: $(uname -m)" >&2; exit 1 ;; + esac + FILE=sei-chain_${VERSION#v}_linux_${ARCH}.tar.gz curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/${FILE} curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/checksums.txt