📄 Revised `gitea-access.md`

1. The SSH Connection Rule

Because this instance runs as the gitea user (not git), all SSH clones must use the gitea prefix.

❌ WRONG:
```
git@code.gluebox.com:tux/repo.git
```
✅ CORRECT:
```
gitea@code.gluebox.com:tux/repo.git
```

2. Required Server Settings (`app.ini`)

For authentication to work correctly across Git and API access, the following must be set:

OFFLINE_MODE     = false     # Ensures internal host resolution works
DISABLE_SSH      = false     # Enables the SSH handshake
LOCAL_ROOT_URL   = http://localhost:3000/   # Critical for internal token verification

3. macOS Setup Flow

🔑 Generate SSH Key

ssh-keygen -t ed25519

🔗 Add to Gitea

Paste your .pub file content into:
User Settings → SSH / GPG Keys

✅ Verify Connection

ssh -T gitea@code.gluebox.com

Expected response:

"Hi there, [username]!"

📥 Clone Command

git clone gitea@code.gluebox.com:tux/rsvp-system-core.git

1.1 KiB Raw Blame History

📄 Revised gitea-access.md