Gitea Setup

Prerequisites

• A Gitea instance (gitea.io or self-hosted)
• A repository where you have admin permissions
• An OpenAI-compatible API key (OpenAI, Anthropic, Groq, Ollama, etc.)

Step 1: Generate Personal Access Token

Create a Personal Access Token (PAT) in Gitea with the required permissions:

1. Log in to your Gitea instance
2. Go to Settings → Applications
3. Click "Generate New Token" (or "Add New Token")
4. Name it something recognizable like "Codecora"
5. Set the token scopes/permissions:

   Required scopes:

   • ✓ repo:code (read/write code)
   • ✓ repo:issues (read/write issues/PRs)
   • ✓ read:user (read user information)

   Note: Scope names may vary slightly between Gitea versions.

6. Click "Generate Token"
7. Important: Copy the token immediately. You won't be able to see it again!

Step 2: Add Gitea to Codecora

1. Go to the Codecora dashboard at codecora.dev/dashboard
2. Click "Add Repository" or "Add Integration"
3. Select "Gitea" as the platform
4. Enter your Gitea instance URL:
   • For gitea.io: https://gitea.io
   • For self-hosted: https://your-gitea-instance.com
5. Paste your Personal Access Token
6. Click "Test Connection" to verify the token works
7. Click "Save" to add the integration

Step 3: Configure Webhook

For Codecora to automatically review your pull requests, configure a webhook in Gitea:

1. Go to your Gitea repository → Settings → Webhooks
2. Click "Add Webhook"
3. Enter the webhook URL:
   https://codecora.dev/webhooks/gitea
4. Select trigger events:
   • ✓ Pull Request events (push, opened, edited, synchronized)
   • ✓ Push events (optional, for branch updates)
5. Choose the content type: application/json
6. Click "Add Webhook"
7. Test the webhook by clicking the "Test Delivery" button

Step 4: Configure AI Provider

Configure your AI provider in the Codecora dashboard:

1. Go to Settings → AI Provider
2. Choose your provider:
   • OpenAI (gpt-4o, gpt-4o-mini)
   • Anthropic (claude-3-5-sonnet)
   • Groq (llama-3.3-70b)
   • Ollama (self-hosted models)
   • Any OpenAI-compatible API
3. Enter your API key or endpoint URL
4. Test the connection
5. Save your settings

Docker Compose Example

Here's an example docker-compose setup for running Gitea with Codecora:

version: "3.8"

services:
  gitea:
    image: gitea/gitea:latest
    environment:
      - GITEA__server__DOMAIN=git.example.com
      - GITEA__server__ROOT_URL=https://git.example.com
      - GITEA__server__SSH_DOMAIN=git.example.com
    ports:
      - "3000:3000"
      - "222:22"
    volumes:
      - gitea_data:/data
    restart: unless-stopped

  codecora-worker:
    image: codecora/worker:latest
    environment:
      - GITEA_URL=https://git.example.com
      - GITEA_PAT=${GITEA_PAT}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    restart: unless-stopped

volumes:
  gitea_data:

Self-Hosted Gitea

Codecora is perfect for self-hosted Gitea instances:

• Works with any Gitea version (1.18+ recommended)
• No complex OAuth setup needed (just use PAT)
• Perfect for homelabs and air-gapped environments
• Can use self-hosted AI models (Ollama) for fully local setup

Troubleshooting

Webhook not triggering?

• Verify the webhook URL: https://codecora.dev/webhooks/gitea
• Check Gitea webhook delivery logs for error messages
• Ensure the webhook secret matches
• Confirm "Pull Request" events are enabled

PAT authentication failed?

• Verify the token has the required scopes
• Check the token hasn't expired
• Ensure you're using the correct Gitea instance URL
• Try regenerating the token

Can't access repositories?

• Ensure your PAT has repo:code and repo:issues scopes
• Verify you have admin access to the repository
• Check you're using the correct instance URL (including https://)

Self-hosted AI not working?

• Ensure Ollama or your AI server is running
• Check the endpoint URL is accessible from Codecora's servers
• For local AI, you may need self-hosted Codecora worker

Homelab & Self-Hosting Community

Gitea + Codecora is a popular combination for homelab enthusiasts:

• Full control: Your code, your infrastructure, your AI models
• Privacy: Nothing leaves your network
• Cost-effective: No monthly fees for Gitea, pay only for AI (or use free local models)
• Flexible: Use any OpenAI-compatible API or self-hosted models

Next Steps

• Set up GitHub
• Set up GitLab
• Join the community