From a1ff6e16a38e9fc1425418efeca158365d3838cd Mon Sep 17 00:00:00 2001 From: Earl Warren Date: Sun, 28 May 2023 08:56:34 +0200 Subject: [PATCH] address review comments from Daniel Gibson --- admin/installation.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/admin/installation.md b/admin/installation.md index fa5808d4..619564f8 100644 --- a/admin/installation.md +++ b/admin/installation.md @@ -151,13 +151,16 @@ services: ## Install Forgejo and git, create git user -> **NOTE:** this guide assumes that you'll host on the server with the domain git.example.com" at the beginning. +> **NOTE:** this guide assumes that you'll host on the server with the domain git.example.com. First, download the Forgejo binary for your CPU architecture and maybe verify the GPG signature, as described on [the Forgejo download page](https://forgejo.org/download/). Next, copy the downloaded Forgejo binary to `/usr/local/bin/` (renaming it to just "forgejo") -and make it executable: +and make it executable: + +> **NOTE:** when a line starts with #, it means the command 'foo --bar' must be run as root (or with sudo). + `# cp forgejo-1.19.3-0-linux-amd64 /usr/local/bin/forgejo` `# chmod 755 /usr/local/bin/forgejo` @@ -227,6 +230,9 @@ Now enable and start the Forgejo service, so you can go on with the installation You should now be able to access Forgejo in your local web browser, so open http://git.example.com/. +> **NOTE:** by default Forgejo will listen to the port 3000 but that +> can be [changed to 80 with HTTP_PORT](../config-cheat-sheet). + If it doesn't work: - Make sure the forgejo service started successfully by checking the output of @@ -252,7 +258,7 @@ Once you're done configuring, click `Install Forgejo` and a few seconds later yo on the dashboard (if you created an administrator account) or at the login/register screen, where you can create an account to then get to the dashboard. -So far, so good, but we're not quite done yet - some manual configuration in the app.ini is needed! +So far, so good, but we're not quite done yet - some manual configuration in the app.ini is needed. ## Further configuration in Forgejo's app.ini @@ -324,7 +330,7 @@ The following changes are recommended if dealing with many large files: - By default LFS files are stored in the filesystem, in `/var/lib/forgejo/data/lfs`. In the `[lfs]` section you can change the `PATH = ...` line to store elsewhere, but you can also configure Forgejo to store the files in an S3-like Object-Storage. -- Enable sending E-Mails with sendmail by changing the `[mailer]` section like this: +- If you want to use the systemwide sendmail, enable sending E-Mails by changing the `[mailer]` section like this: ```ini [mailer] ;; send mail with systemwide "sendmail"