infrastructure-documentation/README.md

The resources used by the infrastructure are in the https://code.forgejo.org/infrastructure/ organization.
There is a [dedicated chatroom](https://matrix.to/#/#forgejo-ci:matrix.org). A mirror of this repository is available at https://git.pub.solar/forgejo/infrastructure-documentation.

## Table of content

- K8S cluster [files and documentation](https://code.forgejo.org/infrastructure/k8s-cluster)
- Setting up a new [LXC/DRBD Host](lxc.md)
- Installing a [Forgejo runner in an LXC container](runner-lxc.md)
- Managing the [Octopuce host](octopuce.md)

## aburayama @ codeberg

Dedicated to hosting Forgejo runners.

See [the codeberg documentation](https://codeberg.org/Codeberg-Infrastructure/meta#ssh-access) for SSH access.

```ssh-config
Host *.lxc.aburayama.local
  User earl
  ProxyJump aburayama.m.codeberg.org

Host *.m.codeberg.org
  User jump
  Port 19198
  ForwardAgent yes
```

## Hetzner

### Help cover the costs

It is possible to help cover the costs of the hardware running at Hetzner by [adding credit](https://docs.hetzner.com/accounts-panel/accounts/payment-faq/#can-i-add-credit-to-my-hetzner-account) with a bank transfert. The client identifier (Customer ID: K06620...) must be added as a reason for the transfert so that Hetzner knows which account must be credited with the funds.

Please reach out to the [devops team](https://codeberg.org/forgejo/governance/src/branch/main/TEAMS.md#devops) to get the information.

### Estimated carbon footprint

[Power consumption declared by Hetzner](https://www.hetzner.com/dedicated-rootserver/matrix-ex/) December 2024:

* ex44 - idle 25W - max 118W
* ex101 - idle 32W - max 116W

[The CO₂ emissions factor in the German electricity mix](https://www.statista.com/statistics/1386327/co2-emissions-factor-electricity-mix-germany/) was 380 grams per kilowatt hour, based on initial estimates for 2023.

* ex101 - idle 75% - max 25%
  - 32W * 24h * 365d * 0.75 = 210kWh
  - 116W * 24h * 365d * 0.25 = 254kWh
  - Total = 464kWh => 139Kg CO2
* ex44 - idle 90% - max 10%
  - 25W * 24h * 365d * 0.90 = 197kWh
  - 118W * 24h * 365 * 0.10 = 103kWh
  - Total = 300kWh => 114Kg CO2

Grand total for 1 ex100 + 3 ex44 => 1 * 139Kg + 3 * 114Kg => 481Kg rounded to 500Kg CO2 per year.

### hetzner01

[EX101](https://www.hetzner.com/dedicated-rootserver/ex101) Hetzner hardware dedicated to LXC containers with [Forgejo runners](runner-lxc).

### hetzner{03,05,06}

https://hetzner03.forgejo.org, https://hetzner05.forgejo.org & https://hetzner06.forgejo.org run on [EX44](https://www.hetzner.com/dedicated-rootserver/ex44) Hetzner hardware.

They are dedicated to the long running K8S cluster [files and documentation](https://code.forgejo.org/infrastructure/k8s-cluster). It is also where some legacy machines that are no longer actively used are preserved, to be revived when/if they are needed. They are in the `/precious/lxc` directory. The root file system are archived in `/precious/hetzner` in case they contain something worth keeping.

- `forgefriends-forum` (hetzner06)

  Dedicated to https://forum.forgefriends.org

  - Docker enabled

- `forgefriends-gitlab` (hetzner06)

  Dedicated to https://lab.forgefriends.org

  - Docker enabled

- `forgefriends-cloud` (hetzner06)

  Dedicated to https://cloud.forgefriends.org

  - Docker enabled

- `gna-forgejo` (hetzner06)

  Dedicated to https://forgejo.gna.org

  - Docker enabled

- `gna-forum` (hetzner06)

  Dedicated to https://forum.gna.org

  - Docker enabled

## Uberspace

The website https://forgejo.org is hosted at
https://uberspace.de/. The https://codeberg.org/forgejo/website/ CI
has credentials to push HTML pages there.