Github setup

Github (source forge) is not git (local-first distributed source control management software)! See Git for using git.

Github setup includes

1. creating or finding an existing remote github repository url
   • avoid conflicting histories: dont generate a readme when creating a new repo
2. syncing that with your files (on your computer, on rhea, on PSC, etc)
   • be sure you cd to the right directory before running git commands
3. authenticating with github for git push permissions.
   • ssh keys recommended
   • ssh-keygen only once per user@server. don't run if existing ~/.ssh/id*.pub

• http://github.com/new or Home > green new repo
• Follow form to assign a name. only add readme, lic, etc if no project files exist locally yet
• Follow the instructions github provides be sure to cd into the code directory before running git commands

  add_remote.bash

  cd my-exsiting-data/ # go to the directory of your existing code
  git remote add origin git@github.com:$USER/$REPONAME
  git push -u origin main

• Copy the ssh url of your new repository. Green <> Code button > Local Tab > SSH header.

• Clone the copied url like

  git clone git@github.com/$USER/$REPO

For git push to github, you'll need some way to confirm your credentials. Authentication can happen with ssh keys (recommended) or an app password

git push can use ssh authentication unique to a user and computer pair. You need a key likely in ~/.ssh/id_ed25519.pub.

Contents of ~/.ssh/id_ed25519.pub should be pasted into new ssh key modal on https://github.com/settings/keys ¹⁾

cat ~/.ssh/id_ed25519.pub

If ~/.ssh/id_ed25519.pub doesn't exist, ssh-keygen can make it (use empty password for convenience. hit enter at password prompt to leave blank). See more documentaiton on github

To push to https (vs ssh like git@) repos, you'll need to use a personal authentication token when prompted for a password. See github's documentation