essesseff
Sign Up

GitHub Organization Argo CD Machine User and PAT Setup Procedure

Quick setup for creating an Argo CD machine user and PAT for use with the essesseff onboarding utility.

  1. Open an incognito browser window, and create an Argo CD machine user account at https://github.com/signup

    • Username: <your-company>-argocd-machine-user (or similar)
    • Use a monitored email address for the Argo CD machine user
    • Verify the email

  2. Add the Argo CD machine user account to your GitHub organization as a member

    • Organization Settings → People → Invite member
    • Add the machine user username (not email address)
    • Consider adding the machine user to a team such as Admin or DevOps Engineers
    • Accept invitation to the GitHub organization as the Argo CD machine user

  3. Create Personal Access Token (Classic)

    • Log in as Argo CD machine user → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token
    • Required scopes: repo, read:packages
    • Set token expiration as desired
    • Copy token immediately (you won't see it again)

  4. Store token in your .essesseff config file:

ARGOCD_MACHINE_USER="argocd-machine-user"
GITHUB_TOKEN="ghp_your_token_here"
ARGOCD_MACHINE_EMAIL="[email protected]"

That's it! Your Argo CD machine user is ready for the essesseff onboarding utility.