gitea-infrastructure/QUICK-SETUP-MIRRORING.md

Quick Setup: Repository Mirroring

Your repository is now on GitHub and ready for mirroring!

Current Status

✅ GitHub Repository: https://github.com/terraphim/gitea-infrastructure ❌ Gitea Repository: Not created yet

Setup Steps

Step 1: Create Repository on Gitea

Via Web Interface:

1. Go to https://git.terraphim.cloud
2. Click "+" → "New Repository"
3. Owner: terraphim
4. Repository Name: gitea-infrastructure
5. Description: Gitea deployment configuration
6. Visibility: ☑️ Private
7. ☐ Uncheck "Initialize Repository"
8. Click "Create Repository"

Result: Empty repository created

Step 2: Push to Gitea

cd /home/alex/infrastructure/gitea-config

# Push to Gitea
git push origin main

Step 3: Configure GitHub Actions Secrets

On GitHub:

1. Go to: https://github.com/terraphim/gitea-infrastructure/settings/secrets/actions
2. Click "New repository secret"
3. Add:
   • Name: GITEA_TOKEN
   • Secret: Your Gitea API token

To create Gitea API token:

1. Go to https://git.terraphim.cloud/user/settings/applications
2. Click "Generate New Token"
3. Token Name: GitHub Actions Sync
4. Select scopes: repo, write:repo
5. Click "Generate Token"
6. Copy the token

Step 4: Test Mirroring

Push to GitHub:

# Make a change
echo "# Mirroring test" >> README.md
git add README.md
git commit -m "test: Mirroring to Gitea"

# Push to GitHub (triggers Actions)
git push github main

Check Gitea:

• Go to https://git.terraphim.cloud/terraphim/gitea-infrastructure
• Verify the commit appears

Current Remote Configuration

# Check remotes
git remote -v

# Should show:
# origin  https://git.terraphim.cloud/terraphim/gitea-infrastructure.git (fetch)
# origin  https://git.terraphim.cloud/terraphim/gitea-infrastructure.git (push)
# github  https://github.com/terraphim/gitea-infrastructure.git (fetch)
# github  https://github.com/terraphim/gitea-infrastructure.git (push)

Two-Way Sync Workflow

Option A: GitHub as Primary (Recommended)

How it works:

1. Developer pushes to GitHub
2. GitHub Actions automatically pushes to Gitea
3. Gitea stays in sync as mirror

Commands:

# Work locally
git push github main  # Primary push (triggers Actions)

# Or push to both manually
git push github main && git push origin main

Option B: Push to Both

Set up alias:

# Add to ~/.gitconfig
git config --global alias.pushall '!git push github $(git branch --show-current) && git push origin $(git branch --show-current)'

# Usage
git pushall  # Pushes to both

Option C: Gitea as Primary

Configure in Gitea:

1. Go to repository Settings → Repository
2. Scroll to Mirror Settings
3. Check "Push Mirror"
4. Git Remote URL: https://github.com/terraphim/gitea-infrastructure.git
5. Authentication:
   • Username: Your GitHub username
   • Password: GitHub Personal Access Token
6. Interval: 1h (or your preference)
7. Click "Add Push Mirror"

To create GitHub token:

1. Go to https://github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Select scope: repo
4. Generate and copy token

Repository Structure

After setup, both repositories will have:

gitea-infrastructure/
├── .docs/                          # Documentation
│   ├── RESEARCH-gitea-bigbox-deployment.md
│   ├── IMPLEMENTATION-gitea-bigbox-deployment.md
│   ├── DEPLOYMENT-SUMMARY.md
│   └── summary-*.md
├── .github/
│   └── workflows/                  # GitHub Actions
│       ├── sync-to-gitea.yml       # Sync GitHub → Gitea
│       └── mirror-check.yml        # Check sync status
├── .gitignore                      # Excludes secrets
├── ARTICLE-gitea-deployment.md     # Main article
├── Caddyfile                       # Caddy config
├── MIRRORING-GUIDE.md              # This guide
├── README.md                       # Project overview
├── REPOSITORY-SETUP.md             # Setup guide
├── deploy-to-bigbox.sh             # Deployment script
├── docker-compose.yml.template     # Template with op://
└── s3_config.json.template         # Template with op://

Verification

Check sync status:

# Manual check
./check-mirror.sh

# GitHub Actions will run every 6 hours automatically

View on GitHub: https://github.com/terraphim/gitea-infrastructure

View on Gitea: https://git.terraphim.cloud/terraphim/gitea-infrastructure

Next Steps

1. ✅ Create Gitea repository
2. ✅ Add GitHub Actions secret (GITEA_TOKEN)
3. ✅ Push to Gitea
4. ✅ Test mirroring with a commit
5. Document your mirroring strategy for team members

Troubleshooting

GitHub Actions failing?

• Check GITEA_TOKEN is set correctly
• Verify Gitea repository exists
• Check Actions logs for details

Gitea push mirror failing?

• Verify GitHub token has repo scope
• Check repository URL is correct
• Review Gitea logs for errors

Conflicts?

• Stop both mirrors
• Resolve conflicts locally
• Push to both repositories
• Re-enable mirrors

---

Your repository is ready for mirroring! 🎉