From f74bd9dc81e343d82e95f41699a505eeb2ac52c4 Mon Sep 17 00:00:00 2001
From: Jason Song <i@wolfogre.com>
Date: Mon, 15 May 2023 23:03:38 +0800
Subject: [PATCH] Docs for creating a user to run Gitea on Fedora/RHEL/CentOS
 (#24725)

The current command doesn't work on Fedora/RHEL/CentOS.

- `--gecos`: use `--comment` instead.
- `--group`: use `--gid` instead, `--group` means "A list of
supplementary groups" on F/R/C.
- `--disabled-password`: leave `--password` empty instead, "The default
is to disable the password".
- `--home`: use `--home-dir` and `--create-home` instead.
---
 docs/content/doc/installation/from-binary.en-us.md | 12 ++++++++++++
 docs/content/doc/installation/from-binary.zh-cn.md | 12 ++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md
index c7824c348025..5c8973fa941f 100644
--- a/docs/content/doc/installation/from-binary.en-us.md
+++ b/docs/content/doc/installation/from-binary.en-us.md
@@ -80,6 +80,7 @@ git --version
 Create a user to run Gitea (e.g. `git`)
 
 ```sh
+# On Ubuntu/Debian:
 adduser \
    --system \
    --shell /bin/bash \
@@ -88,6 +89,17 @@ adduser \
    --disabled-password \
    --home /home/git \
    git
+
+# On Fedora/RHEL/CentOS:
+groupadd --system git
+adduser \
+   --system \
+   --shell /bin/bash \
+   --comment 'Git Version Control' \
+   --gid git \
+   --home-dir /home/git \
+   --create-home \
+   git
 ```
 
 ### Create required directory structure
diff --git a/docs/content/doc/installation/from-binary.zh-cn.md b/docs/content/doc/installation/from-binary.zh-cn.md
index abe799dc94b7..248f03d63fe9 100644
--- a/docs/content/doc/installation/from-binary.zh-cn.md
+++ b/docs/content/doc/installation/from-binary.zh-cn.md
@@ -74,6 +74,7 @@ git --version
 创建用户（推荐使用名称 `git`）
 
 ```sh
+# On Ubuntu/Debian:
 adduser \
    --system \
    --shell /bin/bash \
@@ -82,6 +83,17 @@ adduser \
    --disabled-password \
    --home /home/git \
    git
+
+# On Fedora/RHEL/CentOS:
+groupadd --system git
+adduser \
+   --system \
+   --shell /bin/bash \
+   --comment 'Git Version Control' \
+   --gid git \
+   --home-dir /home/git \
+   --create-home \
+   git
 ```
 
 ### 创建工作路径