python/README_GITEA_PUSH.md

Quick Start: Push Local Repo to Gitea

1. Create repo on Gitea

• Log in → + → New Repository
• Enter repo name → click Create Repository

---

2. Initialize your local repo

cd ~/projects/myproject
git init
git add .
git commit -m "Initial commit"

---

3. Add the remote

Copy the HTTPS or SSH URL from Gitea:

git remote add origin https://gitcenter.dancalloway.com/dancalloway/Python_Projects.git

(or SSH: git@gitcenter.dancalloway.com:dancalloway/Python_Projects.git)

---

4. Push your branch

If your branch is main:

git push -u origin main

If your branch is Main: [Our branch is Main -uppercase M]

git push -u origin Main

---

5. Done

• git push → send changes up
• git pull → fetch changes down
• Repeat add + commit + push as you work

---

⚠️ Important:

• Repos must be created on Gitea first. Pushing to a non-existent repo won’t work (push-to-create is disabled).
• Branch names are case-sensitive (main ≠ Main).

---

🛠️ Troubleshooting Common Git Errors

1. Error: fatal: remote origin already exists 👉 You already added a remote. Fix with:

git remote set-url origin https://gitcenter.dancalloway.com/dancalloway/Python_Projects.git

---

2. Error: non-fast-forward (push rejected) 👉 Your local branch is behind the remote. Update first:

git pull --rebase origin main
git push

---

3. Error: push to create not enabled 👉 You tried pushing to a repo that doesn’t exist. Create it on Gitea first, then retry.

---

4. Error: authentication failed 👉 Check your username/password or SSH key.

• For HTTPS: use your Gitea username + password (or token).
• For SSH: ensure your public key is added under Profile → Settings → SSH / GPG Keys.

---

5. Wrong branch pushed (e.g. Main vs main) 👉 Branch names are case-sensitive. Rename if needed:

git branch -m Main main
git push -u origin main