From 016e0b6f1b383d4f85d028aae746107df74f40ba Mon Sep 17 00:00:00 2001
From: wompmacho <michael@wompmacho.com>
Date: Thu, 2 Apr 2026 09:02:17 +0000
Subject: [PATCH] add a gitea folder / page

---
 projects/gitea/index.md | 69 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 projects/gitea/index.md

diff --git a/projects/gitea/index.md b/projects/gitea/index.md
new file mode 100644
index 0000000..77f3924
--- /dev/null
+++ b/projects/gitea/index.md
@@ -0,0 +1,69 @@
+---
+title: gitea
+description: self hosted git / devops platform
+author: wompmacho
+date: 2026-04-02
+showHero: false
+tags: [git, docker, devops]
+---
+
+## What is Gitea?
+
+Gitea is an open-source, lightweight software package for hosting **Git** repositories. It is designed to be a self-hosted alternative to platforms like GitHub or GitLab, providing a web interface for managing code, tracking issues, and collaborating with others.
+
+One of its most defining characteristics is its efficiency; it is written in **Go** and can run on very low-powered hardware, including a Raspberry Pi or a basic NAS.
+
+---
+
+### Core Features
+
+- **Repository Management**: Gitea provides a familiar interface for managing your code. You can create public or private repositories, manage branches, and view commit histories. It supports **Git LFS** (Large File Storage) for handling big binary files.
+
+- **Collaboration Tools**: 
+  * **Pull Requests:** Facilitate code reviews and discussions before merging changes.
+  * **Issue Tracking:** A built-in system to report bugs, suggest features, and organize tasks with labels and milestones.
+  * **Wikis:** Every repository can have its own dedicated wiki for documentation.
+  * **Kanban Boards:** Visual project management tools to track the progress of issues.
+
+- **Gitea Actions (CI/CD)**: Recent versions of Gitea include **Actions**, a built-in continuous integration and delivery system. It is designed to be compatible with GitHub Actions syntax, allowing you to automate testing and deployment workflows directly within your instance.
+
+- **User and Organization Management**: You can manage multiple users, organize them into teams, and set granular permissions for different repositories. It also supports various authentication methods, including OAuth2, LDAP, and PAM.
+
+---
+
+### Technical Advantages
+
+| Feature                | Description                                                                                             |
+| :--------------------- | :------------------------------------------------------------------------------------------------------ |
+| **Low Resource Usage** | Runs comfortably with minimal RAM and CPU overhead.                                                     |
+| **Cross-Platform**     | Can be installed on Linux, macOS, Windows, and ARM architectures.                                       |
+| **Simple Deployment**  | Usually distributed as a single binary or a **Docker** image, making setup and updates straightforward. |
+| **Database Support**   | Compatible with PostgreSQL, MySQL, MSSQL, and SQLite.                                                   |
+
+---
+
+### Why Choose Gitea?
+
+Gitea is often the preferred choice for developers who want **full control** over their source code without the resource heavy-lifting required by GitLab. It is ideal for:
+
+* **Home Labs:** Perfect for personal projects and self-hosting enthusiasts.
+* **Small Teams:** Provides all the professional tools needed for collaboration without expensive licensing.
+* **Internal Corporate Use:** Keeps sensitive codebases behind a private firewall.
+
+If you are looking for a "no-nonsense" Git hosting solution that feels like GitHub but lives on your own hardware, Gitea is generally the top recommendation.
+
+---
+
+## Docker Compose Example
+
+```sh
+{{<include "/srv/configs/docker_compose/gitea/docker-compose.yaml">}}
+```
+
+## setup
+
+todo
+
+## runners / gitea actions
+
+todo
\ No newline at end of file