G

gitea.com

Gitea is a self-hosted and hosted Git forge for source code hosting, code review, issues, packages, and related collaboration workflows. The `gitea.com` domain hosts the public service and its documentation.

2 integrations · REST

Gitea exposes a REST API at `https://gitea.com/api/v1` plus an OAuth2/OpenID Connect provider on the main host; documented auth options include personal access tokens, HTTP Basic auth, SSH-based HTTP signatures, and OAuth2 app credentials.

discovered 2mo ago
REST · OpenAPI2
Credentials
Personal access tokenapi_keyGet key ↗

In Gitea, open User Settings → Applications and use Manage Access Tokens to create a token. Choose the needed permission scopes; Gitea shows the token only once. The docs also note tokens can be minted via the API at /api/v1/users/{username}/tokens using HTTP Basic auth with your username and password.

Gitea username and passwordbasicGet credentials ↗

Sign in to your Gitea account at gitea.com login. The API docs state HTTP Basic authentication is supported, and that creating tokens via /api/v1/users/{username}/tokens specifically requires Basic auth with your username and password.

Registered SSH key or SSH certificate for HTTP signaturessignatureGet key ↗

Add an SSH public key or SSH certificate to your Gitea account in User Settings → SSH / GPG Keys. Then sign API requests with the matching private key using the draft-cavage HTTP Signatures format; send the signature in the Signature header, and include x-ssh-certificate when using an SSH certificate.

OAuth2 application client credentialsoauth2Set up OAuth ↗

Register an OAuth2 application in Gitea from User Settings → Applications or, for admins, the instance application pages described in the docs. Create an app with a name and redirect URL, then copy the generated Client ID and Client Secret. Use those in the standard OAuth flow against Gitea’s OAuth endpoints; user consent is required.

conventions · 0/7 published

Publish these signals → /publishing