Website/content/docs/infrastructure/forgejo/_index.md

---
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