From 5f6d11916beaf8769306f1e8418aba75367026d5 Mon Sep 17 00:00:00 2001 From: pintop9 Date: Fri, 16 Jan 2026 02:36:19 +0200 Subject: [PATCH 1/5] Added Gitea Documentation Signed-off-by: pintop9 --- tools/Gitea/README.md | 94 ++++++++++++++++++++++++++++++++++++++----- 1 file changed, 85 insertions(+), 9 deletions(-) diff --git a/tools/Gitea/README.md b/tools/Gitea/README.md index b2ec149..de2e30e 100644 --- a/tools/Gitea/README.md +++ b/tools/Gitea/README.md @@ -1,23 +1,99 @@ # Gitea -![Gitea Logo](../logos/gitea.svg) +![Gitea Logo](../../logos/gitea.svg) ## Overview -Gitea is a lightweight, self-hosted Git service written in Go. It provides a simple and fast way to set up your own Git server, offering features like issue tracking, pull requests, and wiki pages. Gitea is designed to be easy to install and maintain, making it ideal for organizations that want to keep their code repositories private and under their control. +Gitea is a lightweight, self-hosted Git service written in Go. It provides a simple and fast way to set up your own Git server, offering features like issue tracking, pull requests, wiki pages, code review, collaboration features, a package registry and CI/CD via Gitea Actions. Gitea is designed to be easy to install and maintain, making it ideal for organizations that want to keep their code repositories private and under their control. ## Key Features -- Feature 1 -- Feature 2 -- Feature 3 +- Git hosting & collaboration: repositories, branches/tags, web code browsing, and access control. Source +- Pull Requests & code review: review workflows with comments and merge support. Source +- CI/CD with Gitea Actions: GitHub Actions–compatible workflow approach. Source +- Package Registry: supports many package types for private/public artifact hosting. Source +- Fast and resource-efficient: designed to remain lightweight while supporting modern Git workflows. Source ## Getting Started -Installation and basic usage instructions. +### Prerequisites + +Install Docker + Docker Compose v2 (Gitea’s docs note Compose v1 is deprecated; use Compose v2). + +Create a working directory: + +`mkdir gitea && cd gitea` +Create docker-compose.yml +``` +version: "3" + +networks: + gitea: + external: false + +services: + server: + image: docker.gitea.com/gitea:1.25.3 + container_name: gitea + environment: + - USER_UID=1000 + - USER_GID=1000 + restart: always + networks: + - gitea + volumes: + - ./gitea:/data + - /etc/timezone:/etc/timezone:ro + - /etc/localtime:/etc/localtime:ro + ports: + - "3000:3000" + - "222:22" +``` +Notes: + +If you use host volumes, ensure the mapped folder is owned by the UID/GID you set, otherwise the container may not start. Source +After first start, config will be written to /data/gitea/conf/app.ini + +Start Gitea: +`docker-compose up -d` + +Complete setup in the browser: +`http://:3000` + +### Option B: Install from Binary (Linux) + +Download + install the binary: +``` +wget -O gitea https://dl.gitea.com/gitea/1.25.3/gitea-1.25.3-linux-amd64 +chmod +x gitea +sudo cp gitea /usr/local/bin/gitea +``` +Prepare the environment +Check that Git is installed (Gitea requires Git >= 2.0): +`git --version` +Create required directories: +``` +sudo mkdir -p /var/lib/gitea/{custom,data,log} +sudo chown -R git:git /var/lib/gitea +sudo chmod -R 750 /var/lib/gitea + +sudo mkdir /etc/gitea +sudo chown root:git /etc/gitea +sudo chmod 770 /etc/gitea +``` +run: +`GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini` + +run as a service: +`sudo systemctl enable gitea --now` + +## Requirements +- Git: version >= 2.0 required. +- Database (choose one): PostgreSQL, MySQL, MariaDB, SQLite (built-in), or MSSQL. +- Recommended baseline (small teams): 2 CPU cores + 1GB RAM. ## Resources -- [Official Website](https://example.com) -- [Documentation](https://docs.example.com) -- [GitHub Repository](https://github.com/example/Gitea) +- [Official Website](https://gitea.io/) +- [Documentation](https://docs.gitea.com/) +- [GitHub Repository](https://github.com/go-gitea/gitea) From e2a4601ea49ea0bb1800992bc71bbb2be1dd9f10 Mon Sep 17 00:00:00 2001 From: pintop9 Date: Fri, 16 Jan 2026 02:44:18 +0200 Subject: [PATCH 2/5] added Gitea documentation for awesome-devops repository Signed-off-by: pintop9 --- tools/Gitea/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Gitea/README.md b/tools/Gitea/README.md index de2e30e..9f27645 100644 --- a/tools/Gitea/README.md +++ b/tools/Gitea/README.md @@ -1,6 +1,6 @@ # Gitea -![Gitea Logo](../../logos/gitea.svg) +LXC Logo ## Overview From dad74b7e3fb8b5a2b28b5c12993b417ffa299460 Mon Sep 17 00:00:00 2001 From: pintop9 Date: Fri, 16 Jan 2026 02:45:04 +0200 Subject: [PATCH 3/5] added Gitea documentation for awesome-devops repository Signed-off-by: pintop9 --- tools/Gitea/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Gitea/README.md b/tools/Gitea/README.md index 9f27645..02bc6a0 100644 --- a/tools/Gitea/README.md +++ b/tools/Gitea/README.md @@ -1,6 +1,6 @@ # Gitea -LXC Logo +Gitea Logo ## Overview From af4b0f0dcd3258a1ad7b600ac6627ee2b8c3bd92 Mon Sep 17 00:00:00 2001 From: pintop9 Date: Fri, 16 Jan 2026 02:45:04 +0200 Subject: [PATCH 4/5] Add Gitea to Awesome DevOps Signed-off-by: pintop9 --- tools/Gitea/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Gitea/README.md b/tools/Gitea/README.md index 9f27645..02bc6a0 100644 --- a/tools/Gitea/README.md +++ b/tools/Gitea/README.md @@ -1,6 +1,6 @@ # Gitea -LXC Logo +Gitea Logo ## Overview From 2d037e2e4a53edbcdd65d1123fafa76fd2a23552 Mon Sep 17 00:00:00 2001 From: pintop9 Date: Fri, 16 Jan 2026 03:58:21 +0200 Subject: [PATCH 5/5] removed the unnecessary text Signed-off-by: pintop9 --- tools/Gitea/README.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/tools/Gitea/README.md b/tools/Gitea/README.md index 02bc6a0..3efe8d0 100644 --- a/tools/Gitea/README.md +++ b/tools/Gitea/README.md @@ -8,11 +8,11 @@ Gitea is a lightweight, self-hosted Git service written in Go. It provides a sim ## Key Features -- Git hosting & collaboration: repositories, branches/tags, web code browsing, and access control. Source -- Pull Requests & code review: review workflows with comments and merge support. Source -- CI/CD with Gitea Actions: GitHub Actions–compatible workflow approach. Source -- Package Registry: supports many package types for private/public artifact hosting. Source -- Fast and resource-efficient: designed to remain lightweight while supporting modern Git workflows. Source +- Git hosting & collaboration: repositories, branches/tags, web code browsing, and access control. +- Pull Requests & code review: review workflows with comments and merge support. +- CI/CD with Gitea Actions: GitHub Actions–compatible workflow approach. +- Package Registry: supports many package types for private/public artifact hosting. +- Fast and resource-efficient: designed to remain lightweight while supporting modern Git workflows. ## Getting Started @@ -24,7 +24,7 @@ Create a working directory: `mkdir gitea && cd gitea` Create docker-compose.yml -``` +```yaml version: "3" networks: @@ -51,7 +51,7 @@ services: ``` Notes: -If you use host volumes, ensure the mapped folder is owned by the UID/GID you set, otherwise the container may not start. Source +If you use host volumes, ensure the mapped folder is owned by the UID/GID you set, otherwise the container may not start. See https://docs.gitea.com/installation/docker/#volumes After first start, config will be written to /data/gitea/conf/app.ini Start Gitea: @@ -63,16 +63,20 @@ Complete setup in the browser: ### Option B: Install from Binary (Linux) Download + install the binary: -``` +```bash wget -O gitea https://dl.gitea.com/gitea/1.25.3/gitea-1.25.3-linux-amd64 chmod +x gitea sudo cp gitea /usr/local/bin/gitea ``` Prepare the environment Check that Git is installed (Gitea requires Git >= 2.0): -`git --version` -Create required directories: + +```bash +git --version ``` + +Create required directories: +```bash sudo mkdir -p /var/lib/gitea/{custom,data,log} sudo chown -R git:git /var/lib/gitea sudo chmod -R 750 /var/lib/gitea