Creating a GitHub account is the first rite of passage for every modern programmer.
However, many beginner tutorials stop after showing you how to click “Sign Up” on the website. Then, the moment you open your terminal to push your code, you hit frustrating authentication errors: Permission denied (publickey) or Support for password authentication was removed.
In this guide, we walk through setting up your GitHub account properly from day one, including global Git credentials, SSH keys, and pushing your first project.
Step 1: Create Your GitHub Account
- Head to github.com and click Sign up.
- Enter your email, create a strong password, and choose a professional username (this will form your portfolio URL:
github.com/your-username). - Complete the puzzle verification and confirm your email address.
Step 2: Configure Your Local Git Profile
Open your terminal (Terminal on Mac/Linux, or Git Bash on Windows) and tell Git who you are. This information attaches to every commit you make:
git config --global user.name "Your Name"
git config --global user.email "your-github-email@example.com"
Verify your configuration:
git config --list
Step 3: Setting Up SSH Authentication (No More Passwords!)
GitHub no longer accepts account passwords when pushing code via the command line. Instead, use an SSH key for passwordless, secure authentication.
1. Generate a New SSH Key
Run this command in terminal (press Enter to accept default file location and add an optional passphrase):
ssh-keygen -t ed25519 -C "your-github-email@example.com"
2. Copy Your Public Key to Clipboard
- macOS:
pbcopy < ~/.ssh/id_ed25519.pub - Linux:
cat ~/.ssh/id_ed25519.pub - Windows (Git Bash):
clip < ~/.ssh/id_ed25519.pub
3. Add Key to GitHub:
- In GitHub, click your profile picture (top right) → Settings.
- In the left sidebar, select SSH and GPG keys.
- Click New SSH key.
- Give it a Title (e.g., MacBook Pro M3) and paste your key into the Key field.
- Click Add SSH key.
Step 4: Create and Push Your First Repository
Now let’s take a local project folder and push it to GitHub:
- On GitHub, click the + icon (top right) → New repository.
- Enter a Repository name (e.g.,
my-first-website). - Set visibility to Public (visible to all) or Private (only you and invited collaborators).
- Leave Add a README unchecked for now. Click Create repository.
In your local project folder in terminal, run:
# 1. Initialize git in your project
git init
# 2. Add your files and commit
git add .
git commit -m "Initial commit"
# 3. Set main branch
git branch -M main
# 4. Link to GitHub (use your SSH URL)
git remote add origin git@github.com:your-username/my-first-website.git
# 5. Push code to GitHub
git push -u origin main
Refresh your GitHub browser page, and your code and commit history will be live online!
Summary
Setting up SSH keys and a clean Git profile takes 5 minutes and permanently eliminates terminal password prompts.
Need full-stack web architecture, GitHub Actions deployment pipelines, or custom software development? Connect with the engineering team at Klickspell.
Need technical precision for your web stack?
Architected for performance & scale.
From modern headless commerce to enterprise infrastructure and clean frontend state systems, Klickspell delivers senior engineering craft without agency bloat.
Keep Reading
Related Engineering Articles
What is GitHub? Git vs. GitHub Explained for Developers & Non-Devs
A clear, beginner-friendly guide breaking down what GitHub is, how it differs from Git, why modern software teams rely on it, and essential concepts like commits, branches, and PRs.
Git Worktrees Explained: Why They're Suddenly Trending (Thanks to AI Coding Agents)
A practical guide to git worktrees: what they are, real disk space and node_modules costs, dev server port collisions, and why AI coding agents revived this decade-old Git feature.