91 lines
2.0 KiB
Markdown
91 lines
2.0 KiB
Markdown
# 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
|
||
```bash
|
||
cd ~/projects/myproject
|
||
git init
|
||
git add .
|
||
git commit -m "Initial commit"
|
||
```
|
||
|
||
---
|
||
|
||
## 3. Add the remote
|
||
Copy the HTTPS or SSH URL from Gitea:
|
||
```bash
|
||
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`:
|
||
```bash
|
||
git push -u origin main
|
||
```
|
||
|
||
If your branch is `Main`: [Our branch is Main -uppercase M]
|
||
```bash
|
||
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:
|
||
```bash
|
||
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:
|
||
```bash
|
||
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:
|
||
```bash
|
||
git branch -m Main main
|
||
git push -u origin main
|
||
```
|