overub/docs/GITEA_SETUP.md

Gitea Setup Guide

This project uses the tea CLI for repository management.

Login

tea login add
tea login list
tea login default <login-name>

Create Repositories

tea repos create --name overub --description "OverUB - Modular Telegram Userbot"
tea repos create --name overub-modules --description "Official OverUB Modules"
tea repos create --name overub-plugins --description "Official OverUB Plugins"

Branch Setup

./scripts/setup-branches.sh overub

Webhook Setup

tea webhooks create \
  --url https://your-bot-server.com/webhook/gitea \
  --events push,release,create \
  --secret your_webhook_secret

Releases

./scripts/create-release.sh v1.0.0

Branch Protection & Channels

tea repos protect-branch main --enable-push --require-signed-commits
tea repos protect-branch beta --enable-push --require-signed-commits
tea repos protect-branch dev --enable-push
tea repos protect-branch lts --enable-push --require-signed-commits

Tokens & SSH Keys

• Create a personal access token with repo and read:user scopes.
• Add SSH keys in Gitea settings and set updates.git.use_ssh and updates.git.ssh_key in config/config.yml.

Repository Layout

overspend1/
  overub/
  overub-modules/
  overub-plugins/

Release Workflow

1. Tag and push: git tag -a v1.0.0 -m "Release v1.0.0" && git push origin v1.0.0
2. Create release with tea: tea releases create --tag v1.0.0 --title "OverUB v1.0.0"

Webhooks

• Use updates.gitea.webhook_secret in config/config.yml.
• Verify webhook signatures in your server endpoint.

CI/CD (Gitea Actions)

.gitea/workflows/test.yml

Tea Automation Scripts

• scripts/setup-gitea.sh
• scripts/setup-branches.sh
• scripts/create-release.sh