Gitea Docs

Gitea Documentation

Official docs for Gitea — a painless self-hosted all-in-one DevOps platform (Git hosting, CI/CD, packages, code review).

CRITICAL: grep references/ for keywords before answering.

Reference Index (98 docs)

Installation (13 docs)

• references/installation/with-docker.md — Docker installation
• references/installation/with-docker-rootless.md — Rootless Docker
• references/installation/on-kubernetes.md — Kubernetes deployment
• references/installation/from-binary.md — Binary installation
• references/installation/from-source.md — Build from source
• references/installation/from-package.md — Package managers
• references/installation/on-cloud-provider.md — Cloud providers
• references/installation/database-preparation.md — Database setup
• references/installation/comparison.md — Comparison with other platforms
• references/installation/upgrade-from-gitea.md — Upgrade guide

Administration (19 docs)

• references/administration/config-cheat-sheet.md — Configuration reference
• references/administration/environment-variables.md — Environment variables
• references/administration/command-line.md — CLI commands
• references/administration/reverse-proxies.md — Reverse proxy setup (Nginx, Apache, Caddy)
• references/administration/https-support.md — HTTPS/TLS setup
• references/administration/email-setup.md — Email/SMTP configuration
• references/administration/logging-config.md — Logging configuration
• references/administration/authentication.md — Authentication (LDAP, OAuth2, PAM)
• references/administration/backup-and-restore.md — Backup and restore
• references/administration/git-lfs-support.md — Git LFS
• references/administration/signing.md — GPG signing
• references/administration/customizing-gitea.md — Customization (templates, CSS)
• references/administration/fail2ban-setup.md — Fail2ban integration

Usage — Actions CI/CD (8 docs)

• references/usage/actions/overview.md — Actions overview
• references/usage/actions/quickstart.md — Actions quickstart
• references/usage/actions/design.md — Actions architecture
• references/usage/actions/comparison.md — Comparison with GitHub Actions
• references/usage/actions/secrets.md — Secrets management
• references/usage/actions/variables.md — Variables
• references/usage/actions/badge.md — Status badges
• references/usage/actions/faq.md — FAQ

Usage — Package Registry (22 docs)

• references/usage/packages/overview.md — Package registry overview
• references/usage/packages/npm.md — npm
• references/usage/packages/pypi.md — PyPI
• references/usage/packages/container.md — Container/OCI images
• references/usage/packages/maven.md — Maven
• references/usage/packages/go.md — Go modules
• references/usage/packages/cargo.md — Cargo (Rust)
• references/usage/packages/helm.md — Helm charts
• references/usage/packages/nuget.md — NuGet
• references/usage/packages/debian.md — Debian/APT
• references/usage/packages/rpm.md — RPM
• references/usage/packages/alpine.md — Alpine APK
• And more (Composer, Conan, Conda, CRAN, Chef, Pub, Swift, Vagrant, RubyGems, Generic, Arch)

Usage — Repository (11 docs)

• references/usage/repository/webhooks.md — Webhooks
• references/usage/repository/repo-mirror.md — Repository mirroring
• references/usage/repository/migration.md — Migration from other platforms
• references/usage/repository/push.md — Push options
• references/usage/repository/code-owners.md — CODEOWNERS
• references/usage/repository/markdown.md — Markdown features
• references/usage/repository/clone-filter.md — Partial clone

Usage — Issues & PRs (6 docs)

• references/usage/issues-prs/pull-request.md — Pull requests
• references/usage/issues-prs/agit.md — AGit flow
• references/usage/issues-prs/labels.md — Labels
• references/usage/issues-prs/issue-pull-request-templates.md — Templates

Usage — Access Control (4 docs)

• references/usage/access-control/permissions.md — Permissions
• references/usage/access-control/protected-branches.md — Protected branches
• references/usage/access-control/protected-tags.md — Protected tags

Development (5 docs)

• references/development/api-usage.md — API usage
• references/development/oauth2-provider.md — OAuth2 provider
• references/development/hacking-on-gitea.md — Development setup
• references/development/migrations.md — Database migrations