compress/gitea-hooks

Git Hooks for Gitea

Automatic synchronization with GitHub after push to Gitea.

📁 Files

• post-receive - Hook for automatic push to GitHub.

🚀 Installation

1. Find Repository Path on Gitea Server

# Usually one of these paths:
/var/lib/gitea/data/gitea-repositories/username/compress.git
# or
/home/git/gitea-repositories/username/compress.git

2. Copy Hook

# On Gitea server
cd /path/to/gitea-repositories/username/compress.git/hooks/

# Copy file
cp /path/to/this/repo/gitea-hooks/post-receive ./

# Or download directly
wget https://raw.githubusercontent.com/username/compress/main/gitea-hooks/post-receive

3. Configure Hook

nano post-receive

Change:

GITHUB_REPO="git@github.com:YOUR_USERNAME/compress.git"

4. Make Executable

chmod +x post-receive
chown git:git post-receive

5. Create Log Directory

mkdir -p /var/log/gitea
chown git:git /var/log/gitea

🔑 Authentication Setup

Option A: SSH (Recommended)

# On Gitea server as git user
sudo su - git
ssh-keygen -t ed25519 -C "gitea-sync"

# Copy public key
cat ~/.ssh/id_ed25519.pub

# Add to GitHub:
# Settings → SSH and GPG keys → New SSH key

# Verify
ssh -T git@github.com

Option B: HTTPS with Token

1. Create Personal Access Token on GitHub

   • Settings → Developer settings → Personal access tokens
   • Scope: repo

2. Use in hook:

GITHUB_REPO="https://YOUR_TOKEN@github.com/username/compress.git"

✅ Verification

# Test push
cd /tmp
git clone http://gitea.example.com/username/compress.git
cd compress
echo "test" >> README.md
git add README.md
git commit -m "Test sync"
git push

# Check log
tail -f /var/log/gitea/github-sync.log

# Check GitHub - changes should appear in 1-2 seconds

📊 What Hook Does

1. ✅ Monitors pushes to main and master branches
2. ✅ Automatically pushes to GitHub
3. ✅ Synchronizes tags
4. ✅ Logs all operations
5. ✅ Shows beautiful output with emojis

🐛 Troubleshooting

Hook Not Firing

# Check permissions
ls -la post-receive
# Should be: -rwxr-xr-x

# Check owner
chown git:git post-receive

# Check syntax
bash -n post-receive

Permission Denied

# For SSH
ssh -T git@github.com

# Check key permissions
chmod 600 ~/.ssh/id_ed25519

# For HTTPS - check token

Can't Find Git

# Add PATH to beginning of hook:
export PATH=/usr/bin:/usr/local/bin:$PATH

📝 Logs

# View sync logs
tail -f /var/log/gitea/github-sync.log

# Clear old logs
> /var/log/gitea/github-sync.log

🔄 Alternatives

If Git Hook doesn't work, see other methods in GITEA_SYNC_EN.md:

• GitHub Actions (every hour)
• Gitea Mirror (built-in feature)
• Double remote (locally)

---

See also: GITEA_SYNC_EN.md for detailed documentation