Document GitHub PAT bootstrap for private-mirror self-pull #4

Merged

josh merged 1 commit from document-github-pat-bootstrap into main 2026-06-17 09:39:21 -05:00

Conversation 0 Commits 1 Files changed 1 +23 -4

josh commented 2026-06-17 09:38:55 -05:00

Owner

Copy link

When self_pull_repo_url points at a private GitHub mirror, the foundry-pull wrapper (running as josh) cannot git clone/fetch without a github.com credential, and the converge fails immediately with fatal: could not read Username for 'https://github.com'.

This adds a third 'role does not manage' prerequisite (alongside .vault-password and private.yml) documenting a github.com line in /home/josh/.git-credentials, plus a numbered bootstrap step to seed the PAT. README-only; no behavior change.

When `self_pull_repo_url` points at a **private** GitHub mirror, the `foundry-pull` wrapper (running as `josh`) cannot `git clone`/`fetch` without a `github.com` credential, and the converge fails immediately with `fatal: could not read Username for 'https://github.com'`. This adds a third 'role does not manage' prerequisite (alongside `.vault-password` and `private.yml`) documenting a `github.com` line in `/home/josh/.git-credentials`, plus a numbered bootstrap step to seed the PAT. README-only; no behavior change.

josh added 1 commit 2026-06-17 09:38:55 -05:00

Document GitHub PAT bootstrap for private-mirror self-pull ... aa5be22893

When self_pull_repo_url points at a private GitHub repo, the foundry-pull
wrapper (running as josh) cannot clone without a github.com credential, and
fails with 'could not read Username for https://github.com'. Document seeding
a PAT into /home/josh/.git-credentials as a one-time bootstrap step, alongside
the existing .vault-password and private.yml prerequisites.

josh merged commit 27088f091a into main 2026-06-17 09:39:21 -05:00

josh referenced this pull request from a commit 2026-06-17 09:39:22 -05:00

Merge pull request 'Document GitHub PAT bootstrap for private-mirror self-pull' (#4) from document-github-pat-bootstrap into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

josh/foundry!4

No description provided.