GitHub setup

Create a GitHub token for Notedog

Notedog uses Git over HTTPS for clone and push. GitHub no longer accepts your account password for that flow; use a personal access token as the password.

Before you start

• Create or choose the GitHub repository you want to use for your journal.
• Use the HTTPS remote URL, for example https://github.com/YOUR-USER/YOUR-REPO.git.
• Treat the token like a password. Copy it once and store it only where you need it.

Create a fine-grained token

1. Open GitHub and go to Settings.
2. Open Developer settings.
3. Under Personal access tokens, choose Fine-grained tokens.
4. Click Generate new token.
5. Give it a clear name, such as Notedog journal, and choose an expiration date.
6. Choose the resource owner for the repository.
7. Set Repository access to Only select repositories, then select your Notedog journal repository.
8. Under Repository permissions, set Contents to Read and write. Leave other permissions unset unless you know you need them.
9. Click Generate token, then copy the token before leaving the page.

Use the token in Notedog

• Remote URL: your HTTPS repository URL, such as https://github.com/YOUR-USER/YOUR-REPO.git.
• Username: your GitHub username.
• Password / token: paste the personal access token you copied from GitHub.

After setup, Notedog can clone from and push to that repository using the token. The journal still lives on your Android device; Git is only the backup you choose.

If fine-grained tokens do not work

Some GitHub organization or collaborator setups may require a classic token. If you use a classic personal access token, choose the smallest scope that works for your repository access. GitHub documents repo as the classic scope for repository access from the command line, but it is broader than a fine-grained token.

Official GitHub docs

GitHub’s token screens and policies can change. If something looks different, use GitHub’s current documentation as the source of truth.