Setting Up the Ultimate Forgejo Server: A Step-by-Step Guide

Take Your Self-Hosted Services to the Next Level

I still remember the first time I tried to set up a self-hosted server. It was a daunting task, with endless options and configurations to consider. But after weeks of trial and error, I finally managed to get everything up and running. Recently, I decided to switch from Gitea to Forgejo, and I was surprised by how much more powerful and flexible it was. In this post, I’ll share my experience and provide a comprehensive guide on how to deploy Forgejo via Docker Compose, with support for Forgejo Actions and more.

Last week, a guide I wrote about automating updates for self-hosted services with Gitea, Renovate, and Komodo was reposted on Reddit. I joined the conversation and mentioned that I had switched to Forgejo, and many people expressed interest in learning more. Instead of updating the original article, I decided to create a dedicated guide for deploying the “ultimate” Forgejo setup. This new guide can be used in conjunction with my previous one, and it covers many more aspects and features of Forgejo.

What to Expect from This Guide

This guide will walk you through the process of deploying and configuring an initial Forgejo instance, including optimized defaults and SMTP mailer configuration for email notifications. You’ll also learn how to deploy and configure a Forgejo Actions Runner, which enables CI/CD and automation features. Additionally, we’ll cover topics such as replacing Forgejo’s built-in authentication with OAuth2/OIDC authentication via Pocket ID, migrating repositories from an existing Gitea instance, and setting up personal and instance GPG commit signing and verification.

Here’s a sneak peek at what we’ll cover:

• Deploying and configuring an initial Forgejo instance/server with optimized defaults
• Deploying and configuring a Forgejo Actions Runner for CI/CD and automation features
• Replacing Forgejo’s built-in authentication with OAuth2/OIDC authentication via Pocket ID
• Migrating repositories from an existing Gitea instance
• Setting up personal GPG commit signing and verification
• Setting up instance GPG commit signing and verification for commits made through the web UI

Getting Started with Forgejo

If you’re new to Forgejo, don’t worry – this guide is designed to be comprehensive and easy to follow. We’ll take it one step at a time, and by the end of this post, you’ll have a fully functional Forgejo server up and running. Whether you’re looking to migrate from Gitea or start from scratch, this guide has got you covered.

Deploying and Configuring Forgejo

The first step in deploying Forgejo is to create a new instance using Docker Compose. This will give us a clean slate to work with and allow us to configure everything from scratch. We’ll use the official Forgejo Docker image and configure it to use a PostgreSQL database.

Once we have our instance up and running, we can start configuring the various settings and features. This includes setting up SMTP mailer configuration for email notifications, configuring the Forgejo Actions Runner, and replacing the built-in authentication with OAuth2/OIDC authentication via Pocket ID.

Migrating from Gitea

If you’re migrating from Gitea, don’t worry – the process is relatively straightforward. We’ll cover the steps to migrate your repositories, including how to configure the migration tool and troubleshoot any issues that may arise.

Setting Up GPG Commit Signing and Verification

GPG commit signing and verification are essential features for any self-hosted server. We’ll cover how to set up personal GPG commit signing and verification, as well as instance GPG commit signing and verification for commits made through the web UI.

Conclusion

Deploying and configuring a Forgejo server can seem daunting at first, but with this guide, you’ll be up and running in no time. Whether you’re looking to migrate from Gitea or start from scratch, this comprehensive guide has got you covered. So why not give it a try and take your self-hosted services to the next level?

Ustawianie serwera Forgejo: Kompletny przewodnik krok po kroku

Zainstaluj serwer Forgejo i podnieś swoje usługi do następnego poziomu

Nadal pamiętam, kiedy po raz pierwszy próbowałem zainstalować serwer hostowany samodzielnie. Było to trudne zadanie, z licznymi opcjami i konfiguracjami, które należało wziąć pod uwagę. Ale po tygodniach prób i błędów w końcu udało mi się wszystko uruchomić. Niedawno zdecydowałem się przerzucić z Gitea na Forgejo i byłam zaskoczony, jak bardzo potężniejszy i bardziej elastyczny jest ten system. W tym poście podzielę się moim doświadczeniem i zapewniam kompletny przewodnik, jak wdrożyć Forgejo za pomocą Docker Compose, z obsługą Forgejo Actions i więcej.

W zeszłym tygodniu przewodnik, który napisałem na temat automatyzacji aktualizacji usług hostowanych samodzielnie z Gitea, Renovate i Komodo został ponownie opublikowany na Reddit. Dołączyłem do rozmowy i wspomniałem, że przerzuciłem się na Forgejo, i wiele osób wyraziło zainteresowanie nauką więcej. Zamiast aktualizować oryginalny artykuł, zdecydowałem się stworzyć dedykowany przewodnik dla wdrożenia “ostatecznego” zestawu Forgejo. Ten nowy przewodnik może być wykorzystany w połączeniu z moim poprzednim, i obejmuje wiele więcej aspektów i funkcji Forgejo.

Czego możesz oczekiwać od tego przewodnika

Przewodnik ten poprowadzi Cię przez proces wdrożenia i konfiguracji początkowej instancji Forgejo, w tym zoptymalizowanych ustawień domyślnych i konfiguracji SMTP mailer dla powiadomień e-mail. Nauczysz się również, jak wdrożyć i skonfigurować uruchomienie Forgejo Actions, które umożliwia funkcje CI/CD i automatyzacji. Dodatkowo, będziemy obejmować tematy takie jak zastąpienie wbudowanej autentykacji Forgejo autentykacją OAuth2/OIDC za pomocą Pocket ID, migrację repozytoriów z istniejącej instancji Gitea, oraz ustawienie podpisu i weryfikacji GPG dla commitów.

Oto podgląd tego, co będziemy obejmować:

• Wdrożenie i konfiguracja początkowej instancji serwera Forgejo z zoptymalizowanymi ustawieniami domyślnymi
• Wdrożenie i konfiguracja uruchomienia Forgejo Actions dla funkcji CI/CD i automatyzacji
• Zastąpienie wbudowanej autentykacji Forgejo autentykacją OAuth2/OIDC za pomocą Pocket ID
• Migracja repozytoriów z istniejącej instancji Gitea
• Ustawienie podpisu i weryfikacji GPG dla commitów
• Ustawienie podpisu i weryfikacji GPG dla commitów dla instancji

Rozpoczęcie pracy z Forgejo

Jeśli jesteś nowy w Forgejo, nie martw się – ten przewodnik jest zaprojektowany, aby być kompletny i łatwy do naśladowania. Weźmiemy to wszystko krok po kroku, i na końcu tego postu będziesz miał w pełni funkcjonalny serwer Forgejo uruchomiony. Niezależnie od tego, czy chcesz przerzucić się z Gitea, czy zacząć od zera, ten przewodnik ma wszystko, czego potrzebujesz.

Wdrożenie i konfiguracja Forgejo

Pierwszym krokiem w wdrożeniu Forgejo jest utworzenie nowej instancji za pomocą Docker Compose. To da nam czyste podłoże do pracy i pozwoli nam na konfigurację wszystkiego od zera. Będziemy korzystać z oficjalnego obrazu Docker Forgejo i skonfigurujemy go do korzystania z bazy danych PostgreSQL.

Gdy tylko będziemy mieli naszą instancję uruchomioną, możemy zacząć konfigurować różne ustawienia i funkcje. To obejmuje ustawienie konfiguracji SMTP mailer dla powiadomień e-mail, konfigurację uruchomienia Forgejo Actions, oraz zastąpienie wbudowanej autentykacji autentykacją OAuth2/OIDC za pomocą Pocket ID.

Migracja z Gitea

Jeśli przerzucasz się z Gitea, nie martw się – proces jest dość prosty. Będziemy obejmować kroki migracji Twoich repozytoriów, w tym jak skonfigurować narzędzie migracji i rozwiązać ewentualne problemy, które mogą wystąpić.

Ustawienie podpisu i weryfikacji GPG

Podpis i weryfikacja GPG są niezbędnymi funkcjami dla każdego serwera hostowanego samodzielnie. Będziemy obejmować, jak ustawić podpis i weryfikację GPG dla commitów, oraz jak ustawić podpis i weryfikację GPG dla instancji dla commitów wykonanych przez interfejs webowy.

Podsumowanie

Wdrożenie i konfiguracja serwera Forgejo może wydawać się trudne na początku, ale z tym przewodnikiem będziesz mógł to zrobić w krótkim czasie. Niezależnie od tego, czy chcesz przerzucić się z Gitea, czy zacząć od zera, ten kompletny przewodnik ma wszystko, czego potrzebujesz. Więc dlaczego nie spróbować i podnieść swoje usługi hostowane samodzielnie do następnego poziomu?