From 59b115c0664c1bb91d3b58c883ccd1b60c6a2ba8 Mon Sep 17 00:00:00 2001 From: Kenneth Bingham Date: Tue, 14 Feb 2023 15:19:14 -0500 Subject: [PATCH 1/3] add download hints for Raspberry Pi, etc. --- docs/getting-started.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/getting-started.md b/docs/getting-started.md index 6d112656..7c123688 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -32,6 +32,14 @@ out directly. Releases are also available from the `zrok` project repository on GitHub at https://github.com/openziti/zrok/releases/latest +You need the right download for your OS and CPU. This can be confusing for Raspberry Pi users because their Raspberry Pi OS could be 32bit or 64bit. Linux users can find the right version by looking up the result of `uname -m` in this table. + +| |macOS |Windows |Linux | +|----------------------------|------------|-------------|------------| +| AMD (x86_64) 64bit |darwin-amd64|windows-amd64|linux-amd64 | +| ARM (aarch64, arm/v8) 64bit|darwin-arm64| |linux-arm64 | +| ARM (armhf, arm/v7) 32bit | | |linux-armv7 | + ### Extract zrok Distribution Move the downloaded `zrok` distribution into a directory on your system. In my case, I've placed it in my home directory: From db177babadac20ecb7694d61e425c78228dd238d Mon Sep 17 00:00:00 2001 From: Kenneth Bingham Date: Tue, 14 Feb 2023 15:40:43 -0500 Subject: [PATCH 2/3] move Linux download hints to Downloads page --- docs/downloads.md | 10 +++++++++- docs/getting-started.md | 10 +--------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/downloads.md b/docs/downloads.md index f72207fb..d86564b2 100644 --- a/docs/downloads.md +++ b/docs/downloads.md @@ -6,4 +6,12 @@ sidebar_position: 100 Right now all `zrok` binaries are delivered from the release page at GitHub. -Head over to https://github.com/openziti/zrok/releases/latest to find the latest downloads. \ No newline at end of file +Head over to https://github.com/openziti/zrok/releases/latest to find the latest downloads. + +You need the right download for your OS and CPU. This can be confusing for Raspberry Pi users because their Raspberry Pi OS could be 32bit or 64bit. Linux users can find the right version by looking up the result of `uname -m` in this table. + +| |Linux Download Name | +|-----------------------------|------------| +| AMD 64bit (x86_64) |linux-amd64 | +| ARM 64bit (aarch64, arm/v8) |linux-arm64 | +| ARM 32bit (armhf, arm/v7) |linux-armv7 | diff --git a/docs/getting-started.md b/docs/getting-started.md index 7c123688..d74da98a 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -30,15 +30,7 @@ out directly. ## Downloading zrok -Releases are also available from the `zrok` project repository on GitHub at https://github.com/openziti/zrok/releases/latest - -You need the right download for your OS and CPU. This can be confusing for Raspberry Pi users because their Raspberry Pi OS could be 32bit or 64bit. Linux users can find the right version by looking up the result of `uname -m` in this table. - -| |macOS |Windows |Linux | -|----------------------------|------------|-------------|------------| -| AMD (x86_64) 64bit |darwin-amd64|windows-amd64|linux-amd64 | -| ARM (aarch64, arm/v8) 64bit|darwin-arm64| |linux-arm64 | -| ARM (armhf, arm/v7) 32bit | | |linux-armv7 | +Releases are also available from the `zrok` project repository on GitHub at https://github.com/openziti/zrok/releases/latest. If you're a Linux user and you're not sure which download to use then check out the hints on [the Downloads page](./downloads.md). ### Extract zrok Distribution From 32f6308eb4467858144125fcb73955cc3eac3911 Mon Sep 17 00:00:00 2001 From: Kenneth Bingham Date: Tue, 14 Feb 2023 16:39:51 -0500 Subject: [PATCH 3/3] make moar download hints better --- docs/downloads.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/downloads.md b/docs/downloads.md index d86564b2..f63245bf 100644 --- a/docs/downloads.md +++ b/docs/downloads.md @@ -8,10 +8,10 @@ Right now all `zrok` binaries are delivered from the release page at GitHub. Head over to https://github.com/openziti/zrok/releases/latest to find the latest downloads. -You need the right download for your OS and CPU. This can be confusing for Raspberry Pi users because their Raspberry Pi OS could be 32bit or 64bit. Linux users can find the right version by looking up the result of `uname -m` in this table. +You need the right download for your OS and CPU. This can be confusing because the OS, e.g., Raspberry Pi OS, could be 32bit even if you have a 64bit Pi (v3, 4, or Zero 2). Linux users can always find the right version by looking up the result of `uname -m` in this table. -| |Linux Download Name | -|-----------------------------|------------| -| AMD 64bit (x86_64) |linux-amd64 | -| ARM 64bit (aarch64, arm/v8) |linux-arm64 | -| ARM 32bit (armhf, arm/v7) |linux-armv7 | +| Result |Linux Download Name | +|------------------|--------------------| +| x86_64 |linux-amd64 | +| aarch64, arm/v8 |linux-arm64 | +| armhf, arm/v7 |linux-armv7 |