engineering/un-inception
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Git Access section with Port 2222 to CLAUDE.md

Browse source 
Critical lesson from 2026-02-05: GitLab runs in Docker with SSH
mapped from host port 2222 to container port 22. Missing Port 2222
in SSH config causes SSH to hit host sshd instead of GitLab, leading
to fail2ban blocks and hours of debugging the wrong thing.

Signed: Agent Blackops
This commit is contained in:
russell@unturf.com 2026-02-05 09:28:27 -05:00
parent 615e2d4107
commit f5545d28d0
1 changed files with 16 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
CLAUDE.md
View file

@ -584,6 +584,22 @@ clients/
clients/python/sync/src/un.py --help
```
## Git Access
SSH to git.unturf.com uses **port 2222** (GitLab runs in Docker). Configure ~/.ssh/config:
```
Host git.unturf.com
HostName git.unturf.com
Port 2222
User git
IdentityFile ~/.ssh/id_ed25519
```
Clone URLs: `git@git.unturf.com:engineering/unturf/un-inception.git`
**CRITICAL LESSON (2026-02-05):** Two hours were wasted debugging "GitLab SSH authentication failures" when the root cause was missing `Port 2222`. SSH was hitting the host's sshd (which banned the IP via fail2ban), never reaching GitLab at all. Always check the obvious first.
## Related Repos
- `~/git/unsandbox.com/` - Portal (contains un.c CLI at cli/un.c)