Explanation

When my backups with roam-to-git started failing every hour in January 2021, I created my own backup solution called roam2github. There are a few changes to make to the Secrets and main.yml, as well as creating another repo to separate the saved backups from the backup jobs (to take advantage of unlimited minutes).

<aside> 💡 If you haven't set up roam2github or roam-to-git before, go here: Roam2Github Backup Guide

</aside>

Directions

1. Delete main.yml

   • Go to your backup repository
   • Navigate to .github/workflows
   • Click main.yml
   • Click the trash icon
   • Click the green "Commit changes" button

   This will stop the failing Actions running on your private repo and using up minutes. We'll still use this repo to save the backups.

2. Add a Personalized Access Token

   • Go to https://github.com/settings/tokens

     Also accessed by going to your account "Settings" (from the dropdown after clicking your profile image in the upper-right), then "Developer settings" in the sidebar, then "Personal access tokens"

   • Click the "Generate new token" button

   • (Re-enter GitHub password if asked)

   • Under "Note", give it a descriptive name, like "Roam backup"

   • Under "Select scopes", click the checkbox for "repo" (this will also check the 5 boxes indented below it)

   <aside> 💡 Note that there is a default expiration of 30 days. You might want to change this to 'No expiration' or set yourself a reminder to regenerate the token. (Thanks Reid)

   </aside>

   • Scroll to the bottom and click the green "Generate token" button
   • You should now see a random string of characters and numbers in a light green background. Click the clipboard icon to copy it. You may want to leave this tab open, just in case you accidentally copy something else. (Because once closed, you'll never see this token again, and have to create a new one.)

3. Create a new, public repository and include README (You can name it something like "roam2github-actions")

   This is where the actions will run and save to your private backup repo.

   If you want it to remain private, that's fine, just be aware of the 2000-minute monthly limit on the free plan. (Usage can be monitored under Billing. My backups take about 3 minutes each time, and running hourly, 2000 minutes is not enough.)

4. Add Secrets

   • Go to "Settings" (for the repo, not your account), then "Secrets"

   • Add "New repository secret" named ACCESS_TOKEN and under Value paste the random token you copied from Step #2

   • Add "New repository secret" named BACKUP_REPO

     The value for this will be your GitHub username, a slash, and the name of your private, backup repo (without <> symbols): <username>/<repo>

     For example, mine is: everruler12/roam-backup

   • Add the following Secrets with appropriate values.

     • ROAM_EMAIL

     • ROAM_PASSWORD

     • ROAM_GRAPH

       You can now add multiple graphs on separate lines.

     You can also delete the old Secrets starting with ROAMRESEARCH_... in your other repo.

5. Add Actions

   • Go to "Actions" (in the header menu at the top of the page, not the left sidebar)
   • Click "set up a workflow yourself →"
   • Delete the code, and replace with the code here https://raw.githubusercontent.com/everruler12/roam2github-actions/main/.github/workflows/main.yml
   • Click the green "Start Commit" button, then "Commit new file"

Issues?

Stay up-to-date with Roam2Github announcements by email:

https://eriknewhard.ck.page/b1cd7d35fa

This will only be used to notify you of updates to Roam2Github, and won't be used for my personal newsletter or anything else.