Skip to main content

Account Setup

Now that your development tools are installed, let's set up the online accounts you'll need for this workshop. We'll create and configure both GitHub and Cloudflare accounts.

1. GitHub Account Setup​

What is GitHub? GitHub is a cloud-based platform where developers store and manage their code repositories. It's essential for version control and collaboration.

Create GitHub Account (if needed)​

Already have a GitHub account?

  • Yes: Perfect! Make sure you can log in at github.com
  • ❌ No: Follow the steps below to create one

Create New Account:

  1. Visit github.com
  2. Click "Sign up" in the top-right corner
  3. Choose a username (this will be part of your repository URLs)
  4. Provide your email address
  5. Create a strong password
  6. Complete the verification process

github signup

Verify GitHub Access​

After creating your account:

  1. Log in to github.com
  2. Verify your email address (check your inbox for a verification email)
  3. Complete your profile setup (optional but recommended)

Configure Git with GitHub​

Link your local Git installation with your GitHub account:

terminal
git config --global user.name "Your GitHub Username"
git config --global user.email "your-github-email@example.com"
warning

Important: Use the same email address associated with your GitHub account.

configure_git

2. Cloudflare Account Setup​

What is Cloudflare? Cloudflare is a cloud platform that provides serverless computing, CDN, and other web services. We'll deploy our application to Cloudflare's global network.

Create Cloudflare Account​

Already have a Cloudflare account?

Create New Account:

  1. Visit cloudflare.com
  2. Click "Sign up"
  3. Enter your email address and create a password
  4. Verify your email address
  5. Complete the account setup process

cloudflare signup

Explore Cloudflare Dashboard​

After creating your account:

  1. Log in to dash.cloudflare.com
  2. Familiarize yourself with the dashboard layout
  3. Note the main navigation sections:
    • Workers & Pages: Where we'll deploy our applications
    • R2 Object Storage: For file storage
    • D1: For our database

cloudflare workers

3. Wrangler Authentication​

Now we'll connect the Wrangler CLI tool to your Cloudflare account for seamless deployment.

Authenticate Wrangler​

Run the authentication command:

terminal
wrangler login

wrangler login

Complete Authentication Process​

What happens next:

  1. Your default web browser will open automatically
  2. You'll be redirected to Cloudflare's authentication page
  3. If you're not already logged in, enter your Cloudflare credentials
  4. Review the permissions Wrangler is requesting

wrangler login web

Grant Permission:

  1. Review the permissions carefully
  2. Click "Allow" to grant Wrangler access to your Cloudflare account
  3. You should see a success message in your browser
  4. Return to your terminal

wrangler login success

Verify Authentication​

Confirm the authentication was successful:

terminal
wrangler whoami

Expected output: Your Cloudflare account email address

Example:

👋 You are logged in with an OAuth Token, associated with the email 'your-email@example.com'!

wrangler whoami

Troubleshooting Authentication​

Browser doesn't open automatically:

terminal
wrangler login --browser=false

This will provide a manual login URL to copy and paste.

wrangler login browse false

Authentication fails
  • Check your internet connection
  • Disable VPN if you're using one
  • Try a different browser
  • Clear browser cache and cookies for cloudflare.com
Permission denied errors
  • Ensure you're using the correct Cloudflare account
  • Verify your account has the necessary permissions
  • Try logging out and back in: wrangler logout then wrangler login

Setting up SSH keys makes GitHub operations more secure and convenient.

Generate SSH Key​

Check for existing SSH keys:

terminal
ls -al ~/.ssh

ls sshkey

Generate new SSH key (if needed):

terminal
ssh-keygen -t ed25519 -C "your-github-email@example.com"

When prompted:

  • Press Enter to accept the default file location
  • Enter a passphrase (optional but recommended)

ssh key gen

Add SSH Key to GitHub​

Copy your public key:

terminal
pbcopy < ~/.ssh/id_ed25519.pub

Add to GitHub:

  1. Go to GitHub → Settings → SSH and GPG keys
  2. Click "New SSH key"
  3. Give it a descriptive title (e.g., "Workshop Laptop")
  4. Paste your public key
  5. Click "Add SSH key"

git_addkey

git_addnewsshkey

Test SSH Connection​

terminal
ssh -T git@github.com

Expected response:

Hi [username]! You've successfully authenticated, but GitHub does not provide shell access.

ssh connection

5. Account Verification Checklist​

Before proceeding, verify all accounts are properly set up:

GitHub Account​

  • GitHub account created and verified
  • Can log in to github.com
  • Git configured with GitHub email and username
  • SSH key added (optional but recommended)

Cloudflare Account​

  • Cloudflare account created and verified
  • Can log in to dash.cloudflare.com
  • Wrangler CLI authenticated successfully
  • wrangler whoami shows correct email

Authentication Tests​

  • git config --global user.name shows your name
  • git config --global user.email shows your email
  • wrangler whoami shows your Cloudflare email
  • SSH test to GitHub successful (if configured)

What's Next?​

Excellent! Your accounts are now set up and authenticated.

Next Step: Repository Setup - Fork and clone the project repositories to your local machine.

Need Help?​

GitHub Issues:

Cloudflare Issues:

Wrangler Issues:

Your accounts are the foundation for everything we'll build. Great job getting this set up! 🚀