0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-24 18:09:26 -05:00
Commit graph

699 commits

Author SHA1 Message Date
Kwonunn
4b4c81a4bf Fix copying mistake
(cherry picked from commit d88ef00889)
2024-09-24 07:30:46 +00:00
Kwonunn
0817341127 Improve runner installation instructions (#860)
This PR rewrites the runner installation instructions, with the following changes:

- deduplicate instructions as much as possible
- explicitly instruct to create a separate user for the runner
- reword the label explanations
- split the instructions for administrating the actions feature from the installation guide for the Forgejo Runner
- add instructions for setting up the runner as a systemd service

https://forgejo.codeberg.page/@docs_pull_860/docs/next/admin/actions
https://forgejo.codeberg.page/@docs_pull_860/docs/next/admin/runner-installation/
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/860
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Kwonunn <kwonunnx@gmail.com>
Co-committed-by: Kwonunn <kwonunnx@gmail.com>
(cherry picked from commit 9567aff03a)
2024-09-20 03:49:19 +00:00
Earl Warren
f368a6c990 user: OAuth2 section title typo
(cherry picked from commit 1a72849b87)
2024-09-16 12:03:14 +00:00
Gusted
d9db2175eb Remove CLI documentation in config cheat sheet
The configuration cheat sheet isn't the canonical documentation for the
CLI and this particular bit has no relation to `ENABLE_PPROF` setting
anymore.
Resolves forgejo/forgejo#5268

(cherry picked from commit ef75a59038)
2024-09-16 11:58:42 +00:00
Otto Richter
7e2362133f simplify installation quickstart
Goal: prevent situations like https://codeberg.org/forgejo/forgejo/issues/5278 where users run Forgejo without reading the detailed setup guide.
(cherry picked from commit 10dff2ee1a)
2024-09-11 10:20:18 +00:00
yonas
e25e9dd4ad Update Docker installation instructions to use v8
(cherry picked from commit be2d4d2c8c)
2024-09-08 15:12:59 +02:00
Joaquin Dominguez
c5283b5c9e updated container file to remove timezone and localtime volume
(cherry picked from commit 7fd780c085)
2024-09-08 08:41:40 +02:00
Joaquin Dominguez
33ed0f457f updated installation-docker.md file with Podman instructions
(cherry picked from commit e2dd73e88b)
2024-09-08 08:41:18 +02:00
Otto Richter
6978d24268 Update database preparation guide
- it is related to installation instructions
- mention SQLite in the guide
- reduce the complexity of the guide (I think we don't need to cover all the details here, there are better guides available)
2024-09-05 13:31:13 +02:00
Otto Richter
bc685cb08c Update binary installation instructions
(cherry picked from commit 182007a5a5)
2024-09-05 11:27:48 +00:00
mahlzahn
a894bb40fd Fix location of gitconfig user file
(cherry picked from commit 7c5ef2e7e2)
2024-09-04 21:45:35 +00:00
Sai Nane
96a3002657 admin: Reword, format consistency
This changes terminal command blocks to always use the multiline formatting,
as the leading octothorpe looks very strange when displaying a command inline.
Two consecutive inline commands at the start was very difficult to read in the
generated html. See:
https://forgejo.org/docs/latest/admin/installation-binary/

`HTTP_PORT` has been highlighted as a code term. This also means we don't need
to worry about another underscore in the same line being added and interpreted
as syntax.

Simplifies and fixes sentence structure in a few places. I've seen arguments
for and against the use of "just" in technical writing, but I think here it's
better without?

Reworded some paragraphs so that the command comes at the end.

(cherry picked from commit facf05de24)
2024-09-04 21:35:35 +00:00
Christoph Heiss
a594aaf4a9 admin: cheat-sheet: fix SCHEDULE description for extended cron tasks
Signed-off-by: Christoph Heiss <christoph@c8h4.io>
(cherry picked from commit 3de284c2c9)
2024-08-24 15:25:12 +00:00
Gusted
4366dbfb25 Remove pause queue step
This step can no longer be done, because this functional was removed
some releases ago.

(cherry picked from commit 6b2a74e82c)
2024-08-14 17:59:35 +00:00
RobertoMaurizzi
1d7aaa4840 tell users where to write the variables
(cherry picked from commit c1aec9211e)
2024-08-13 14:32:02 +00:00
0ko
a4ce1a795f admin: actualize LOGIN_REMEMBER_DAYS recommendation
(cherry picked from commit ded0ad6f85)
2024-08-05 15:39:25 +00:00
matrss
8e609fda70 Fix incorrect referenced number of databases
(cherry picked from commit faca0b8961)
2024-08-05 15:30:38 +00:00
0ko
f7aad31459 admin: sync i18n language lists with Forgejo code
(cherry picked from commit 359d69f279)
2024-08-04 19:07:29 +00:00
Panagiotis "Ivory" Vasilopoulos
5fad974201 developer/customization: improve CustomPath hints
Additionally, the notice for restarting Forgejo was rewritten
to be more explicit.

(cherry picked from commit 85fbfe4885)
2024-08-02 15:10:28 +00:00
Panagiotis "Ivory" Vasilopoulos
15696a612d admin: cheat sheet, improve USER_LOCATION_MAP_URL
(cherry picked from commit 7cc3393317)
2024-08-02 15:06:30 +00:00
mahlzahn
13ce8a2b20 Fix label application instructions
(cherry picked from commit ce7ca34bcb)
2024-08-01 05:31:08 +00:00
Massimiliano Adamo
55354e145b add haproxy documentation (#781)
- add documentation to use haproxy
- add documentation to use unix socket
- add warning about NGINX binary distributions

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/781
Reviewed-by: thefox <thefox@noreply.codeberg.org>
Co-authored-by: Massimiliano Adamo <maxadamo@gmail.com>
Co-committed-by: Massimiliano Adamo <maxadamo@gmail.com>
(cherry picked from commit abbc414b1f)
2024-07-28 18:43:45 +00:00
Earl Warren
bdea37706d
admin: installation: remove double restrictions 2024-07-27 06:51:54 +02:00
Emmanuel BENOÎT
3019c8f742 admin: more details about action runner offline registration (#769)
This PR
- adds more details regarding the nature of the secret used when registering runners offline using `forgejo-cli actions register`,
- explains how to change the secret for an existing runner ([Forgejo PR #4619](https://codeberg.org/forgejo/forgejo/pulls/4619)),
- explains how to keep the Forgejo-side command idempotent if the labels aren't known ([Forgejo PR #4610](https://codeberg.org/forgejo/forgejo/pulls/4610))

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/769
Reviewed-by: twenty-panda <twenty-panda@noreply.codeberg.org>
Co-authored-by: Emmanuel BENOÎT <tseeker@nocternity.net>
Co-committed-by: Emmanuel BENOÎT <tseeker@nocternity.net>
(cherry picked from commit 65f556b638)
2024-07-24 05:54:12 +00:00
Twenty Panda
d10536ebbc user: actions: add on.issues
(cherry picked from commit 46a3f68002)
2024-07-23 15:48:06 +00:00
Earl Warren
0f7b177592
the v8.0 branch documents the v8.0 release 2024-07-15 12:07:32 +02:00
Earl Warren
38020acc52 the v8.0 branch was cut
(cherry picked from commit 68730eec12)
2024-07-15 10:02:24 +00:00
Mai-Lapyst
3817c7f5e2 Document the on.workflow_dispatch event trigger 2024-07-14 10:37:23 +00:00
0ko
00102c44e2 admin: cheat sheet, clarify proxy configuration 2024-07-14 10:35:33 +00:00
Elias Elwyn
07db480c04 admin: expand on the redis cache adapter 2024-07-13 16:57:58 +10:00
Earl Warren
5d725ecdc3 admin: installation: docker rootless does not have USER_UID/USER_GID
The USER_UID/USER_GID are not interpretd in the rootless image, use
`user: "1024:100"` in the docker-compose example instead.

Fixes: https://codeberg.org/forgejo/docs/issues/704
2024-07-10 06:57:16 +00:00
Earl Warren
ba7b5de019 developer: release process: rewrite and LTS toolchain
* do not include patch releases in the release schedule
* fix the Gitea compatibility of 7.0 & 8.0
* change the feature freeze from two to three weeks. See
  * https://codeberg.org/forgejo/discussions/issues/180
	* https://codeberg.org/forgejo/discussions/issues/187
* remove cutting a release in favor of copy/pasting previous
  checklists
* remove release notes as it is not done on a rolling basis
* move the runner publication down as it was in the middle
  of the release process sections
* reminder of LTS toolchain upgrades
2024-07-04 21:15:04 +00:00
patdyn
6eb8451336 Add link and short description for env to ini 2024-07-04 11:42:58 +00:00
Earl Warren
9ab29a27fa
developer: dependencies: document upgrades on stable branches 2024-07-04 09:30:58 +02:00
Ikuyo Kita
b10a9127dd user: block: Update screenshots to reflect current version and be concistent (#741)
This PR changes the screenshots in the Blocking users page. It not only updates the block user dialog shown in the page (since it has been [changed](/forgejo/forgejo/pulls/4204) to have better wording and explanation), but it also changes the other screenshots to be consistent with the rest of the page, oh and they used (old?) Gitea theme, not Forgejo)

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/741
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Ikuyo Kita <kitakita@disroot.org>
Co-committed-by: Ikuyo Kita <kitakita@disroot.org>
2024-07-02 13:34:59 +00:00
Shiny Nematoda
9f420e366b user(code search): mention branch/tag dropdown 2024-07-02 08:16:24 +00:00
Earl Warren
feeb7e68a4 developer: infrastructure: map v8.next 2080 to port 22 (#737)
it helps to minimize the need for configuration if the default port is
used instead of a custom one.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/737
Reviewed-by: Michael Kriese <michael.kriese@gmx.de>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-07-01 13:17:34 +00:00
Michael Jerger
98dac9cb1f Documentation for federated-star (#639)
Preview:

* https://forgejo.codeberg.page/@docs_pull_639/docs/next/developer/federation-architecture/
* https://forgejo.codeberg.page/@docs_pull_639/docs/next/developer/threat-analysis/
* https://forgejo.codeberg.page/@docs_pull_639/docs/next/developer/adr/

Co-authored-by: patdyn <erik.seiert@meissa-gmbh.de>
Co-authored-by: Clemens <clemens.geibel@meissa-gmbh.de.de>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/639
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Michael Jerger <michael.jerger@meissa-gmbh.de>
Co-committed-by: Michael Jerger <michael.jerger@meissa-gmbh.de>
2024-06-29 16:47:25 +00:00
Earl Warren
ff00778463
developer: infrastructure: v8.next.forgejo.org runs out of hetzner04 2024-06-29 14:43:32 +02:00
Earl Warren
15624dd36e
developer: infrastructure: add runner container for lxc-helpers 2024-06-29 14:43:32 +02:00
Earl Warren
eae00f8834
developer: infrastructure: upgrade the runner example to 3.5.0 2024-06-29 14:43:32 +02:00
Earl Warren
296ce286e5
developer: infrastructure: wrong container name in example for LXC 2024-06-29 14:43:31 +02:00
Earl Warren
dc2849ab18
developer: infrastructure: nft command reminder 2024-06-29 14:43:31 +02:00
Earl Warren
6cc67e3e04
developer: infrastructure: no specifics in Forgejo nginx example 2024-06-29 14:43:31 +02:00
Joachim Durchholz
2678e40581 reverse-proxy.md: Clearer and more admin-centric intro
- Eliminated confusing topic switch https->proxy->https.
- Moved all HTTPS mentions to end of intro.
- Added paragraph about when you'd want a reverse proxy.
- Use /code for subpath, to encourage purpose-based naming
2024-06-26 05:02:42 +00:00
Earl Warren
7e730394a2
developer: infrastructure: remove ubuntu-runner.forgejo.org
It is no longer useful as explained at:

https://codeberg.org/forgejo-contrib/snap/pulls/10#issuecomment-2041440
2024-06-24 18:59:54 +02:00
cascading-pr
7c7a6cfe12 cascading-pr update 2024-06-24 13:43:55 +00:00
avobs
866d79d0fe Update docs/user/blocking-user.md (#677)
Spamming a repository is only meaningful in the issues.

https://forgejo.codeberg.page/@docs_pull_677/docs/next/user/blocking-user/
Co-authored-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/677
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: avobs <avobs@noreply.codeberg.org>
Co-committed-by: avobs <avobs@noreply.codeberg.org>
2024-06-24 11:37:17 +00:00
Twenty Panda
7e60f058d1 user: actions: add examples to the cache 2024-06-22 20:25:39 +00:00
Ikuyo Kita
b2c12f3897 user: issue-tracking-basics: correct some parts 2024-06-22 20:01:57 +00:00