Prerequisites

Creating a private repository

If you already have an existing repository synced from another location, you can skip this step.

We will be creating a new private repository on GitHub to hold the files you want to sync. While this offers a secure and private solution, keep in mind that no system is completely immune to determined attackers.

Log into your GitHub account.

Click your profile icon in the top right.

Profile icon on github.com

Select “Repositories” from the sidebar.

"Repositories" in sidebar

Click “New” to create a new repository.

New repository button on github.com

Enter the repository details:

  • Name (required)
  • Description (optional)
  • No need to initialize with a README, add a .gitignore, or select a license.

Click “Create repository”.

Screen Shot 2025-01-20 at 19 45 14

You’re all set!

Next steps

GitSync will guide you through the setup process when you install it, for the most part. However, here are detailed instructions for key steps you need to have completed:

  1. Authenticate with the default GitHub oAuth option (or any other provided auth option)
  2. Select the repo you created in the previous step from the “Clone remote repository” list
  3. Select a (or create a new) empty local directory to hold the files to be synced and wait for the initial clone to complete
  4. (optional) Copy any initial contents you want to start with into the directory from the previous step
  5. (optional) Turn on auto sync when a particular app is opened or closed on the device (or use one of the many other sync options provided)