Docs

GitHub Integration

Learn how to integrate GitHub with Cokpit

GitHub Credentials

Step 1: Create Access Token on GitHub

Example: Personal Access Token

  1. Go to GitHub Settings → Developer Settings → Personal Access Tokens.

  2. Click Generate new token.

  3. Give your token a descriptive name.

  4. Select required scopes:

    • repo (Full control of private repositories)
    • workflow (Update GitHub Action workflows)
    • Other scopes as needed
  5. Click Generate token.

  6. Copy your token immediately.

💡 Tip: Store your token securely. You won't be able to see it again!

Step 2: Add GitHub Credentials to Cokpit

  1. Open Cokpit and go to Integrations → Version Control → GitHub.
  1. Click Add secret.

  2. Fill in the required fields:

    • Enter a unique Secret Name
    • Enter your GitHub Username
    • Paste your Access Token
    • Enter your GitHub Email
  3. Click Submit.

Security Best Practices

  • Create tokens with minimal required permissions
  • Use different tokens for different applications
  • Regularly rotate your access tokens
  • Enable two-factor authentication on GitHub
  • Monitor token usage in GitHub security logs