I spent a good chunk of time today iterating on customizing Forgejo to have a different logo, favicon, and start page. The docs say that the repo is not going try to be backwards compatible in this area, so I want to write this down because I’ll probably have to do it again.

Here are the doc links:

• Forgejo - Interface customization ¹

Setting a custom logo for your instance, serving custom public files or modifying pages shown by Forgejo (such as the homepage) is possible. However, they impose an additional maintenance burden on administrators and, most importantly, are unsupported.

Unsupported means that future updates are likely to break your changes without any warning.