Add Forgejo documentation

This commit is contained in:
this.ven 2024-02-26 07:40:08 +01:00
parent 27b281ad06
commit 5f8e042009

View file

@ -5,9 +5,40 @@ draft: true
---
[Forgejo](https://forgejo.org/) enables me to share the sources of my projects
and use [version control](https://en.wikipedia.org/wiki/Version_control) during
iteration. As a [soft-fork of Gitea](https://forgejo.org/compare/#faq) it
compares to other platforms and providers (BitBucket, GitHub, etc.) in that it
and use version control[^1] during iteration. As a
[soft-fork of Gitea](https://forgejo.org/compare/#faq)
it compares to other platforms and providers (BitBucket, GitHub, etc.) in that it
provides most crucial features while being a lightweigt, self-hostable solution.
{{< figure src="img/forgejo-wordmark.svg" alt="Forgejo logo" width="25%" >}}
[^1]: [Version control](https://en.wikipedia.org/wiki/Version_control) in the
Wikipedia
{{< figure src="img/forgejo-wordmark.svg" alt="Forgejo logo" width="25%" >}}
{{< callout type="info" >}}
Some links in this guide lead to the docs of [Codeberg](https://codeberg.org/)
as they develop Forgejo and use it to drive an alternative collaboration
platform providing Git hosting and services for free and open source software,
content and projects.
{{< /callout >}}
## Basic setup
The official [installation](https://forgejo.org/docs/latest/admin/installation/) guide covers typical scenarios including a migration from Gitea. I refer to the
[Forgejo — UberLab 7 documentation](https://lab.uberspace.de/guide_forgejo/) for
a basic setup and use Forgejo's own documentation for further adjustments.
## Security
To [securely](https://docs.codeberg.org/security/) use Forgejo I refer to guides
on:
- Setting up two-factor authentication
- Adding an SSH key to your account
- Adding a GPG key to your account
Two-Factor authentication[^2] is found in the user drop down menu in *Settings*
\> *Security* and *SSH / GPG keys* is another separate menu entry in the
settings page.
[^2]: [Multi-factor authentication](https://en.wikipedia.org/wiki/Multi-factor_authentication)
in the Wikipedia