Commit Graph

80 Commits (1c523e212913cdb6fc2b0709af7f4c910d1728c8)

Author SHA1 Message Date
Melroy van den Berg 508aca1cc0
Improve Docker container name ()
* Improve Docker container name

Use a better Docker container name than the default 'server'

* Changing to gitea and use recommended v3 Docker-compose

Use `gitea` as container name. And use version 3 of the docker-compose, which should now be used: https://docs.docker.com/compose/compose-file/compose-versioning/

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
Divyam Bhasin 48703c3c68
updated docs with caveat for authorized_keys ()
* updated docs with caveat for authorized_keys

* wrapped authorized_keys in ticks

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
Lunny Xiao 0d0e01eaa9
Fix typo on Chinese documents ()
Bagas Sanjaya b725c4ee53
Add a step for binding IP address for listening on remote database ()
* Add listen address configuration step
  * Fix numbering order

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>

Co-authored-by: Lauris BH <lauris@nix.lv>
Florian Klink 95d478c29c
change PIDFile default from /var/run/gitea.pid to /run/gitea.pid ()
* docs: update heading

This section covers more paths than the 3 listed in the heading.

* setting: change PIDFile default from /var/run/gitea.pid to /run/gitea.pid

On most modern distributions, /var/run is deprecated and only kept for
backwards compat according to
https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch05s13.html, and is a
symlink to `/run/` on modern distributions.

Old Distros that still don't have `/run` can update the gitea default as
described in from-source.en-us.md to point to the old location.

Co-authored-by: Lauris BH <lauris@nix.lv>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
zeripath ac3cfad23d
Make the default PID file compile-time settable ()
 offered to change the default PID file from /var/run/gitea.pid however in discussion it was decided that this could break users of older systems. An alternative was offered that we could make the PID file compile/link time settable.

This PR does this, and changes the name of the setting from CustomPID to simply PIDFile. It also updates the from-source docs to show how to change the compiler settings to do this.

Closes 

Signed-off-by: Andrew Thornton <art27@cantab.net>
Co-authored-by: Florian Klink <flokli@flokli.de>
6543 78d17b4b43
Make default StaticRootPath compile time settable ()
Make it possible to compile the default location of StaticRootPath independent from AppWorkPath

Co-authored-by: Andrew Thornton <art27@cantab.net>
techknowlogick 4d2c2962d3
recommend bindata for building ()
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Girish Ramakrishnan e282fbe753
cloudron: update link to demo ()
Will 保哥 464b583c6c
Update from-package.zh-tw.md ()
Add translation for `install-from-package` page

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
Will 保哥 7305b555d3
Add chocolatey package install instructions ()
* Update from-package.en-us.md

https://github.com/go-gitea/gitea/issues/10800

* Update docs/content/doc/installation/from-package.en-us.md

Co-authored-by: zeripath <art27@cantab.net>

Co-authored-by: zeripath <art27@cantab.net>
Co-authored-by: techknowlogick <techknowlogick@gitea.io>
6543 7d9946f989
Docs: add AlpineLinux packages ()
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: Lauris BH <lauris@nix.lv>
John Olheiser 41be230867
Add awesome-gitea reference on install from package docs ()
Signed-off-by: jolheiser <john.olheiser@gmail.com>
techknowlogick 08611fb765
Update docs to reflect new location of homebrew repo ()
Co-authored-by: Lauris BH <lauris@nix.lv>
Co-authored-by: zeripath <art27@cantab.net>
Adrian POIGET 99082eebd7
Fix; declare DOMAIN variable for docker setup ()
In the /install form, the value for SSH Server Domain is taken form the DOMAIN variable
and overwrites SSH_DOMAIN environment variable set the first time if nothing done

Co-authored-by: Adrian POIGET <adrian.poiget@viveris.fr>
Km d0e7361bd9
Propose an explanation how to restart gracefully gitea after an update ()
Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: Lauris BH <lauris@nix.lv>
zeripath 1853131d42
Use keys.openpgp.org instead of pgp.mit.edu ()
The SKS Keyserver network has been under attack with poisoned
certificates since at least 2019. Downloading a poisoned certificate has
the awful side-effect of completely breaking your keyring and most
software has now moved off the network and uses the keys.openpgp.org
which has a different protocol instead - in fact one whereby emails are
verified.

For more details regarding the attack see: https://gist.github.com/rjhansen/67ab921ffb4084c865b3618d6955275f

See: https://keys.openpgp.org/about and https://keys.openpgp.org/about/faq

Signed-off-by: Andrew Thornton <art27@cantab.net>

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Bagas Sanjaya 8592fb7121
[Docs] Cross Build Gitea from Source ()
* Add cross-build docs

Note that C cross compiler is required for building Gitea with `TAGS`.

* Apply suggestion from @mrsdizzie

Co-Authored-By: mrsdizzie <info@mrsdizzie.com>

* Apply suggestion from @guillep2k

Co-Authored-By: guillep2k <18600385+guillep2k@users.noreply.github.com>

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: mrsdizzie <info@mrsdizzie.com>
Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Bagas Sanjaya 51140a970f
[Docs] Database Preparation - Connection over TLS ()
* Database Preparation - Connection over TLS

* Step 6 MySQL edit

- have been created [before -> earlier]
- recreate user, [and this time]

* Apply suggestions from @guillep2k

Co-Authored-By: guillep2k <18600385+guillep2k@users.noreply.github.com>

* certificat[e] typo

Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
Co-authored-by: Lauris BH <lauris@nix.lv>
John Olheiser 3f0cb8b33a
Remove test from installation directions ()
Signed-off-by: jolheiser <john.olheiser@gmail.com>
John Olheiser f5a20250ae
Add node version variable to docs ()
Also adjusted other version mentions so go version is always mentioned
as major.minor and node only as major.

Co-authored-by: silverwind <me@silverwind.io>
guillep2k be544e8e6a
Versions ()
Signed-off-by: jolheiser <john.olheiser@gmail.com>
Karsten Lehmann 17581252e4
Fixed formatting ()
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Ask Bjørn Hansen b098cc24c5
Use documentation IPs for example IPs ()
See https://tools.ietf.org/html/rfc5737

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Co-authored-by: Lauris BH <lauris@nix.lv>
6543 fa3381610c
update discord link ()
Ask Bjørn Hansen c97433d07d
docs: Fix MySQL create database syntax ()
Signed-off-by: Ask Bjørn Hansen <ask@develooper.com>
silverwind 2ed9ead6de
Add frontend/backend make targets, fix source release ()
* Add frontend/backend make targets, fix source release

- Add 'make backend' and 'make frontend' make targets which are used to
  build go and js/css/svg files respectively.

- The 'backend' target can be invoked without requiring Node.js to be
  present on the system if pre-built frontend assets are present like
  in the release source tarballs.

- Fix source releases missing 'dist' folders inside 'node_modules' which
  were erronously excluded from tar.

- Store VERSION in file VERSION for the release tarballs and prefer that
  file over git-derived version.

* fix release task

* fix typo

* fix another typo
Bagas Sanjaya 530f8963f3
[Docs] Database Preparation ()
* Database Preparation

* Apply suggestions from @guillep2k

Co-Authored-By: guillep2k <18600385+guillep2k@users.noreply.github.com>

* Repeat strong password notice on PostgreSQL

* Add prerequisite note

* Use utf8mb4 instead of utf8

* Use utf8mb4 if complete character coverage wanted

* utf8mb4 recommended

* Reword utf8mb4 recommendation

* Set InnoDB global variables may be needed

* Reorder step number

* Whoops, bump year date

* Remove `SET GLOBAL`s and step number reorder

It is assumed that such global variables value are already as default on MySQL 5.7 and later, so those are redundant.

* Syntax edit on MySQL GRANT PRIVILEGEs

* DB engine uniformity intro edit

Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: zeripath <art27@cantab.net>
Co-authored-by: Antoine GIRARD <sapk@users.noreply.github.com>
zeripath 82a979707a
Update documentation for the go module era ()
* Update documentation for the go module era

use go env instead of $GOPATH

Update instructions to just use git clone

Slight update to readme

Signed-off-by: Andrew Thornton <art27@cantab.net>

* fixup

* Apply suggestions from code review

Co-Authored-By: Antoine GIRARD <sapk@users.noreply.github.com>
Co-Authored-By: Bagas Sanjaya <bagasdotme@gmail.com>

* Apply suggestions from code review

* Fix GOPATH settings

Co-authored-by: Antoine GIRARD <sapk@users.noreply.github.com>
Co-authored-by: Bagas Sanjaya <bagasdotme@gmail.com>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: techknowlogick <techknowlogick@gitea.io>
Bagas Sanjaya b822518e39 [Docs] Linux Service Edit ()
* Rename h3 title

* Add intro

Should work on Ubuntu Xenial, but should work on any Linux distros.

* Indirect edit files

Instead of providing `sudo vim`, invite to edit files.

* enable now instead of enable and start

* Re-add systemctl enable && systemctl start

* Revert service enablement back to status quo

* Add enable now counterpart for systemd > v220

* Apply suggestions from @sapk

Strip `vim` from editor usage

Co-Authored-By: Antoine GIRARD <sapk@users.noreply.github.com>

Co-authored-by: Antoine GIRARD <sapk@users.noreply.github.com>
Matthew Bramer 39db99a595 Supports both CMD and PowerShell ()
sc is aliased to Set-Content in PowerShell and these commands will not work without the `.exe` extension.
silverwind 3f42934b9a Remove explicit 'generate' calls, fix release task ()
* Remove more explicit 'generate' calls

`generate` is now implicit during `build` since , it is no longer
necessary or desired to specify it explicitely.

* add js,css,generate dependencies to release task

* remove generate warning as per @lunny
Lunny Xiao 48be1889cd Fix latest docker image haven't include static files. ()
* add warnging on docs

* fix docs
silverwind d9c67a8c90 Add Node.js build dep, remove built js/css files ()
- Added Node.js as build dependency and removes build files from git.
- Added version checks for both Go and Node.js.
- Overhauled the js/css make target to only run when needed.
- Merged the `generate` make target into `build` as per suggestion.

Fixes: https://github.com/go-gitea/gitea/issues/6782
Fixes: https://github.com/go-gitea/gitea/issues/9216
Wars c9b564ccdb fix(docs): Fixed creating Windows service commands ()
escaping " to \"
Florian Hübner 27ac1d0952 add /etc/timezone and /etc/localtime volumes ()
Passing these volumes to the container enable gitea to use hosts localtime and timezone.
This is a mandatory change when using the "Setup fail2ban" Guide, but it is not described in the documentation.
zeripath 115a1cc680
Fix building from source docs to ref AppWorkPath ()
The current source docs reference AppWorkDir instead of AppWorkPath
8ctopus 8a828500e6 Doc config file should not be readable by others as it contains sensitive info ()
leigh capili 70d2244e49 Support SSH_LISTEN_PORT env var in docker app.ini template ()
Signed-off-by: leigh capili <leigh@null.net>
John Olheiser 4ea9a377db Add config option and shortcode for Gitea version ()
Signed-off-by: jolheiser <john.olheiser@gmail.com>
Lunny Xiao 87404d7c0b Use vendors when go generate ()
* use vendors when go generate

* update docs about golang minimal requirement from 1.9 to 1.11

* fix build
Alexandru Bucur 36448bc923 1.8.3 release ()
Marat Radchenko e07ff2f890 [docker] Add LFS_START_SERVER option to control git-lfs support ()
suisseWalter 181b7c99ed Added Note about arm7 version to doc ()
Appended the Troubleshooting section with a subsection about the problems with the arm7 version and the recommendation to switch to arm6.
zeripath 8d0d7bc28d Make CustomPath, CustomConf and AppWorkPath configurable at build ()
John Olheiser 9bf20f47c4 Enabled emoji in Hugo ()
Removed extra asterisks in Docker doc

Signed-off-by: jolheiser <john.olheiser@gmail.com>
nodiscc 0f54f42646 docs: document setup with read-only config ()
zeripath 04d78b60f8 Fix link to Hacking on Gitea on From-Source doc page ()
* fix rel-ref

* fixup
Aidan Fitzgerald f5cf9a8355 Copyedit docs ()
John Olheiser 4b7237b63e Doc updates for customization and installation. ()
* Doc updates and changing default sqlite DB path

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Update customizing locales and THEMES

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Add link to templates directory

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Add portion for final step of running Gitea

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Add recommended to service file usage

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Removed DB path change, moving to another PR
Updated doc sentence structure

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Revert change to template wording

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Move recommended run-type to top