📝 I do not recommend the use of GitHub Desktop
- GitHub repository setup
- Create a GitHub Personal Access Token (PAT)
- Git setup
- Vault setup
- Obsidian git plugin setp
GitHub repository setup
- If you do not have an account with GitHub, you can create one here.
After you have created an account and logged in, you can create a new repo from the + sign in the top right.
Choose a repo name, make it Public or Private as you see fit. Tick Add Readme
You should be left with a repo resembling this. If you are presented a “how to” that means you did not include the ReadMe. Delete the repo via the Settings and re-make it.
Create a GitHub Personal Access Token (PAT)
These GitHub docs are decent enough: Creating a personal access token - GitHub Docs
- Install git for Windows, MacOS, or Linux.
Open a PowerShell window or Terminal, this should open in the root of your user directory.
📝 For the purpose of this guide, we will put our repo here, if you want to put it somewhere else
cdthere but we will not be covering it.
To pull down the bare repository from GitHub run
git clone <url of the repo>
📝 Get the URL for the repo out of your browser.
📝 You will be asked to log into GitHub, or for a password. If you are asked for a plain password use the Personal Access Token (PAT) you generated above.
You can now open your File Explorer to find a directory named the same thing as your Repo. It will have a ReadMe file inside that you can remove.
📝 The repo is located in the root of your User Profile. Such as
- Add any files you want to into the repo. The root of your repository should be treated as the root of your vault.
- Once files are added open a new PowerShell and run the following:
1 2 3 4
cd Obsidian_Repo git add . git commit -a -m 'initial commit' git push
You should now be able to view your files online in your GitHub repo.
Obsidian git plugin setp
- From the plugins pane in Obsidian add the “Obsidian Git” plugin.
Configure the various timers as you see fit to automatically sync and push your vault. My settings are below:
- From now on the auto-magical timers should keep your vault syncing to the cloud without issue!