50 lines
No EOL
1.8 KiB
Markdown
50 lines
No EOL
1.8 KiB
Markdown
---
|
|
title: 'Forgejo'
|
|
date: 2024-02-04T17:52:58+01:00
|
|
weight: 2
|
|
---
|
|
|
|
[Forgejo](https://forgejo.org/) enables me to share the sources of my projects
|
|
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%" >}}
|
|
|
|
{{< 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.
|
|
|
|
## Guides
|
|
|
|
{{< cards >}}
|
|
{{< card link="git-lfs" title="Git LFS" icon="database" >}}
|
|
{{< card link="submodules" title="Submodules" icon="puzzle" >}}
|
|
{{< /cards >}}
|
|
|
|
[^1]: [Version control](https://en.wikipedia.org/wiki/Version_control) in the
|
|
Wikipedia
|
|
[^2]: [Multi-factor authentication](https://en.wikipedia.org/wiki/Multi-factor_authentication)
|
|
in the Wikipedia |