From 9bb184a80feddd5e114777f8fbfd975ad8d475b8 Mon Sep 17 00:00:00 2001 From: Alex Papadimoulis Date: Mon, 25 Jul 2022 16:41:32 +0900 Subject: [PATCH 1/6] Added guidance on file to choose to download --- .../doc/installation/from-binary.en-us.md | 28 ++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 91a6b2a9d6d29..e707a5eef444f 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -24,13 +24,39 @@ embedded assets. This can be different for older releases. ## Download -Choose the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/), copy the URL and replace the URL within the commands below: +You can find the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/) after navigating to the version you want to download. +### Choosing the right file +For Linux, you should choose: + * `linux-386` for 32-bit Intel/AMD processors + * `linux-amd64` for 64-bit Intel/AMD processors + * 'linux-arm64' for 64-bit ARM systems like a Raspberry PI 4 + * `linux-arm-5` and `linux-arm-6` are for other versions of the ARM processor + +For Windows, you should chose: + * `windows-4.0-386` for 32-bit Intel/AMD processors + * `windows-4.0-amd64` for 64-bit Intel/AMD processors + * `gogit-windows` if you want to use the built-in (Go-based) git client; otherwise you will need to install Git. + +*Note that `windows-4.0` refers to Windows NT+, which is all modern versions of Windows.* + +For macOs, you should choose: + * `darwin-amd64` for AMD/Intel x86/64-bit processors + * `darwin-arm64` for 64-bit ARM systems like a Raspberry PI 4 + +### Downloading with wget + +Copy the commands below and replace the URL within the one you wish to download. ```sh wget -O gitea https://dl.gitea.io/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64 chmod +x gitea ``` +Note that the above command will download Gitea {{< version >}} for 64-bit Linux. + + + + ## Verify GPG signature Gitea signs all binaries with a [GPG key](https://keys.openpgp.org/search?q=teabot%40gitea.io) to prevent against unwanted modification of binaries. From e76a440c8ffb2bdd917573f4af3646265287b260 Mon Sep 17 00:00:00 2001 From: Alex Papadimoulis Date: Tue, 26 Jul 2022 16:37:55 +0900 Subject: [PATCH 2/6] Update from-binary.en-us.md --- docs/content/doc/installation/from-binary.en-us.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index e707a5eef444f..563f30bdb5684 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -34,9 +34,10 @@ For Linux, you should choose: * `linux-arm-5` and `linux-arm-6` are for other versions of the ARM processor For Windows, you should chose: - * `windows-4.0-386` for 32-bit Intel/AMD processors - * `windows-4.0-amd64` for 64-bit Intel/AMD processors - * `gogit-windows` if you want to use the built-in (Go-based) git client; otherwise you will need to install Git. + * `gogit-windows-4.0-386` for 32-bit Intel/AMD processors + * `gogit-windows-4.0-amd64` for 64-bit Intel/AMD processors + +The `gogit-windows` file addresses [significant performance problems](https://github.com/go-gitea/gitea/pull/15482) that have been reported on Windows by including a built-in, Go-based git client for some operations. The `windows`-only file (i.e. without `gogit`) will exclusively use whichever git is client installed on the server. *Note that `windows-4.0` refers to Windows NT+, which is all modern versions of Windows.* @@ -55,8 +56,6 @@ chmod +x gitea Note that the above command will download Gitea {{< version >}} for 64-bit Linux. - - ## Verify GPG signature Gitea signs all binaries with a [GPG key](https://keys.openpgp.org/search?q=teabot%40gitea.io) to prevent against unwanted modification of binaries. From c60b8a83bf93dec4252200e2e3ef50f76309592a Mon Sep 17 00:00:00 2001 From: Alex Papadimoulis Date: Tue, 26 Jul 2022 23:49:08 -0400 Subject: [PATCH 3/6] Update from-binary.en-us.md --- .../doc/installation/from-binary.en-us.md | 18 ++++-------------- 1 file changed, 4 insertions(+), 14 deletions(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 563f30bdb5684..1dff0f6c6c696 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -27,23 +27,13 @@ embedded assets. This can be different for older releases. You can find the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/) after navigating to the version you want to download. ### Choosing the right file -For Linux, you should choose: - * `linux-386` for 32-bit Intel/AMD processors - * `linux-amd64` for 64-bit Intel/AMD processors - * 'linux-arm64' for 64-bit ARM systems like a Raspberry PI 4 - * `linux-arm-5` and `linux-arm-6` are for other versions of the ARM processor +**For Linux**, you will likely want `linux-amd64`. It's for 64-bit Intel/AMD platforms, but there are other platforms available, including `arm64` (e.g. Raspberry PI 4), `386` (i.e. 32-bit), `arm-5`, and `arm-6`. -For Windows, you should chose: - * `gogit-windows-4.0-386` for 32-bit Intel/AMD processors - * `gogit-windows-4.0-amd64` for 64-bit Intel/AMD processors +**For Windows**, you will likely want `windows-4.0-amd64`. It's for all modern versions of Windows, but there is also a `386` platform available designed for older, 32-bit versions of Windows. -The `gogit-windows` file addresses [significant performance problems](https://github.com/go-gitea/gitea/pull/15482) that have been reported on Windows by including a built-in, Go-based git client for some operations. The `windows`-only file (i.e. without `gogit`) will exclusively use whichever git is client installed on the server. +*Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.* -*Note that `windows-4.0` refers to Windows NT+, which is all modern versions of Windows.* - -For macOs, you should choose: - * `darwin-amd64` for AMD/Intel x86/64-bit processors - * `darwin-arm64` for 64-bit ARM systems like a Raspberry PI 4 +**For macOs**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel. ### Downloading with wget From 39e138ef2a1904898dc93318988e625d1cd085bd Mon Sep 17 00:00:00 2001 From: Alex Papadimoulis Date: Wed, 27 Jul 2022 23:35:01 -0400 Subject: [PATCH 4/6] Update from-binary.en-us.md --- docs/content/doc/installation/from-binary.en-us.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 1dff0f6c6c696..9b0529fd7cf96 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -24,11 +24,12 @@ embedded assets. This can be different for older releases. ## Download -You can find the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/) after navigating to the version you want to download. +You can find the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/) after navigating to the version you want to download. ### Choosing the right file + **For Linux**, you will likely want `linux-amd64`. It's for 64-bit Intel/AMD platforms, but there are other platforms available, including `arm64` (e.g. Raspberry PI 4), `386` (i.e. 32-bit), `arm-5`, and `arm-6`. - + **For Windows**, you will likely want `windows-4.0-amd64`. It's for all modern versions of Windows, but there is also a `386` platform available designed for older, 32-bit versions of Windows. *Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.* @@ -38,6 +39,7 @@ You can find the file matching your platform from the [downloads page](https://d ### Downloading with wget Copy the commands below and replace the URL within the one you wish to download. + ```sh wget -O gitea https://dl.gitea.io/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64 chmod +x gitea @@ -45,7 +47,6 @@ chmod +x gitea Note that the above command will download Gitea {{< version >}} for 64-bit Linux. - ## Verify GPG signature Gitea signs all binaries with a [GPG key](https://keys.openpgp.org/search?q=teabot%40gitea.io) to prevent against unwanted modification of binaries. From 2f2a539af03cd7c54dd47da50ff27fd4b885ffed Mon Sep 17 00:00:00 2001 From: wxiaoguang Date: Thu, 28 Jul 2022 11:44:51 +0800 Subject: [PATCH 5/6] Update docs/content/doc/installation/from-binary.en-us.md --- docs/content/doc/installation/from-binary.en-us.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 9b0529fd7cf96..321e50d598ff0 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -34,7 +34,7 @@ You can find the file matching your platform from the [downloads page](https://d *Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.* -**For macOs**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel. +**For macOS**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel. ### Downloading with wget From 693029d7b964f4f71c4d0104072263bc4b6b0f05 Mon Sep 17 00:00:00 2001 From: wxiaoguang Date: Thu, 28 Jul 2022 11:46:27 +0800 Subject: [PATCH 6/6] Update docs/content/doc/installation/from-binary.en-us.md --- docs/content/doc/installation/from-binary.en-us.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 321e50d598ff0..f603fe37cfd0a 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -32,7 +32,7 @@ You can find the file matching your platform from the [downloads page](https://d **For Windows**, you will likely want `windows-4.0-amd64`. It's for all modern versions of Windows, but there is also a `386` platform available designed for older, 32-bit versions of Windows. -*Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.* +*Note: there is also a `gogit-windows` file available that was created to help with some [performance problems](https://github.com/go-gitea/gitea/pull/15482) reported by some Windows users on older systems/versions. You should consider using this file if you're experiencing performance issues, and let us know if it improves performance.* **For macOS**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel.