diff options
author | Lauris BH <lauris@nix.lv> | 2018-06-05 05:02:04 +0300 |
---|---|---|
committer | techknowlogick <techknowlogick@users.noreply.github.com> | 2018-06-04 22:02:04 -0400 |
commit | 1aee261aae74881f65a1152f6fa57bc160adaa16 (patch) | |
tree | 6c329fb4a43fe7d39f56ef30ac44ddb81600a29c /docs | |
parent | 6400d8a3cba41d1435fa0fbe0b5b060062f41e1c (diff) | |
download | gitea-1aee261aae74881f65a1152f6fa57bc160adaa16.tar.gz gitea-1aee261aae74881f65a1152f6fa57bc160adaa16.zip |
More detailed documentation on how to set up from binary (#4121)
* More detailed documentation on how to set up from binary
Also change recommended file locations
Diffstat (limited to 'docs')
-rw-r--r-- | docs/content/doc/installation/from-binary.en-us.md | 52 |
1 files changed, 50 insertions, 2 deletions
diff --git a/docs/content/doc/installation/from-binary.en-us.md b/docs/content/doc/installation/from-binary.en-us.md index 91f81f73f1..9c88592155 100644 --- a/docs/content/doc/installation/from-binary.en-us.md +++ b/docs/content/doc/installation/from-binary.en-us.md @@ -20,8 +20,8 @@ embedded assets. This can be different for older releases. Choose the file match the destination platform from the [downloads page](https://dl.gitea.io/gitea), copy the URL and replace the URL within the commands below: -``` -wget -O gitea https://dl.gitea.io/gitea/1.3.2/gitea-1.3.2-linux-amd64 +```sh +wget -O gitea https://dl.gitea.io/gitea/1.4.2/gitea-1.4.2-linux-amd64 chmod +x gitea ``` @@ -34,6 +34,54 @@ location. When launched manually, Gitea can be killed using `Ctrl+C`. ./gitea web ``` +## Recommended server configuration + +### Prepare environment + +Check that git is installed on the server, if it is not install it first. +```sh +git --version +``` + +Create user to run gitea (ex. `git`) +```sh +adduser \ + --system \ + --shell /bin/bash \ + --gecos 'Git Version Control' \ + --group \ + --disabled-password \ + --home /home/git \ + git +``` + +### Create required directory structure + +```sh +mkdir -p /var/lib/gitea/{custom,data,indexers,public,log} +chown git:git /var/lib/gitea/{data,indexers,log} +chmod 750 /var/lib/gitea/{data,indexers,log} +mkdir /etc/gitea +chown root:git /etc/gitea +chmod 770 /etc/gitea +``` + +**NOTE:** `/etc/gitea` is temporary set with write rights for user `git` so that Web installer could write configuration file. After installation is done it is recommended to set rights to read-only using: +``` +chmod 750 /etc/gitea +chmod 644 /etc/gitea/app.ini +``` + +### Copy gitea binary to global location + +``` +cp gitea /usr/local/bin/gitea +``` + +### Create service file to start gitea automatically + +See how to create [Linux service]({{< relref "run-as-service-in-ubuntu.en-us.md" >}}) + ## Troubleshooting ### Old glibc versions |