gitea-docs

Provide installation and administration documentation for self-hosted Gitea deployments.

7|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/wenerme/ai --skill gitea-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitea-docs
Source: https://github.com/wenerme/ai/tree/main/skills/gitea-docs
Command: npx skills add https://github.com/wenerme/ai --skill gitea-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you quickly find accurate, practical documentation for installing, configuring, operating, and troubleshooting a self-hosted Gitea instance.

Core Features & Use Cases

  • Installation guidance: Covers deployment options like Docker, rootless Docker, Kubernetes, binaries, source builds, database preparation, and platform comparisons.
  • Administration and operations: Explains configuration reference details, environment variables, reverse proxy and HTTPS/TLS setup, email/SMTP, logging, authentication methods, backup/restore, Git LFS, GPG signing, fail2ban integration, and customization patterns.
  • Usage and development references: Documents common features like Actions CI/CD, packages/registries, webhooks, repository administration workflows, issue/PR concepts, access control, plus developer-focused topics (API usage, OAuth2 provider, migrations, and contributing/development setup).

Quick Start

Use the gitea-docs skill to answer: “How do I configure Gitea behind a reverse proxy with HTTPS, and what settings do I need for authentication and backups?”

Frequently Asked Questions about gitea-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Gitea behind a reverse proxy with HTTPS and TLS?

Configuring Gitea behind a reverse proxy with HTTPS and TLS requires setting specific environment variables and updating the configuration reference to ensure proper header forwarding and secure connections.

What is the best way to backup and restore a self-hosted Git repository?

The best way to backup and restore a self-hosted Git repository in Gitea involves documented administration procedures that capture database dumps, repository files, and Git LFS objects for complete operational recovery.

Does Gitea support deployment on Kubernetes and Docker?

Yes, Gitea supports deployment on Kubernetes and Docker, offering installation guidance for both platforms alongside rootless Docker, binary, and source build deployment options with database preparation steps.

How do I set up authentication and fail2ban integration for Gitea?

Setting up authentication and fail2ban integration for Gitea involves configuring supported authentication methods within the administration settings and applying fail2ban rules to monitor logs and block malicious access.

Can I use Gitea Actions for CI/CD pipelines and package registries?

Yes, you can use Gitea Actions for CI/CD pipelines and package registries, as the usage and development references document these core features alongside webhooks and API usage for workflow automation.

What are the limitations when configuring OAuth2 provider and email SMTP in Gitea?

Limitations when configuring the OAuth2 provider and email SMTP in Gitea depend on your specific environment setup, requiring careful alignment of external authentication sources and SMTP server settings with documented configuration references.