.. _generate-github-access-token:

=======================================
Generate GitHub Access Tokens
=======================================


1. **Sign In to GitHub**

   Navigate to `GitHub <https://github.com>`_ and sign in.

   .. image:: ../assets/screenshots/github_user_token_1.png

2. **Navigate to Settings**

   Click on your profile picture at the top-right corner and go to "Settings."

   .. image:: ../assets/screenshots/github_user_token_3.png

.. tip::
   Using dark mode can reduce eye strain--and make you a pro developer
   *\*cough**.

3. **Developer Settings**

   Choose "Developer settings."

   .. image:: ../assets/screenshots/github_user_token_4.png

4. **Personal Access Tokens**

   Go to "Personal access tokens."

   .. image:: ../assets/screenshots/github_user_token_5.png

5. **Generate New Token**

   Click "Generate new token."

   .. image:: ../assets/screenshots/github_user_token_6.png

.. warning::
   The selection of scopes is crucial. Avoid over-scoping permissions and consult the service documentation for required scopes.

6. **Configure Token**

   Set the token name, expiration, and required scopes, then click "Generate token."

   .. image:: ../assets/screenshots/github_user_token_7.png

7. **Copy Token**

   Copy the generated token.

   .. image:: ../assets/screenshots/github_user_token_8.png

.. important::
   Never commit code that contains your tokens. Most services will
   automatically deactivate compromised tokens.