143 lines
2.7 KiB
Markdown
143 lines
2.7 KiB
Markdown
# 🔧 Git Setup & Push Troubleshooting
|
|
|
|
## ✅ What to Do Now
|
|
|
|
Run this command:
|
|
```bash
|
|
SETUP_GIT_AND_PUSH.bat
|
|
```
|
|
|
|
This will:
|
|
1. Initialize git in the directory
|
|
2. Configure your credentials
|
|
3. Add the Gitea remote
|
|
4. Add all files
|
|
5. Create a commit
|
|
6. Push to Gitea
|
|
|
|
---
|
|
|
|
## 🔐 Authentication
|
|
|
|
When prompted, enter:
|
|
- **Username**: `jessikitty`
|
|
- **Password**: Your Gitea password or personal access token
|
|
|
|
### If You Don't Have a Token
|
|
1. Go to: https://gitea.hideawaygaming.com.au/user/settings/applications
|
|
2. Click "Generate New Token"
|
|
3. Name it: "Family Hub CLI"
|
|
4. Click "Generate Token"
|
|
5. Copy the token (save it somewhere safe!)
|
|
6. Use this token instead of your password
|
|
|
|
---
|
|
|
|
## ⚠️ Common Issues
|
|
|
|
### Issue 1: "Remote repository already has commits"
|
|
|
|
**Solution**: Pull first, then push
|
|
```bash
|
|
cd D:\Hosted\familyhub
|
|
git pull origin main --allow-unrelated-histories
|
|
git push origin main
|
|
```
|
|
|
|
### Issue 2: "Authentication failed"
|
|
|
|
**Solution**: Use a personal access token instead of password
|
|
1. Generate token (see above)
|
|
2. Use token as password when prompted
|
|
|
|
### Issue 3: "Already exists" error for remote
|
|
|
|
**Solution**: Update remote URL
|
|
```bash
|
|
cd D:\Hosted\familyhub
|
|
git remote set-url origin https://gitea.hideawaygaming.com.au/jessikitty/family-hub.git
|
|
git push origin main
|
|
```
|
|
|
|
### Issue 4: Want to overwrite remote completely
|
|
|
|
**Solution**: Force push (CAUTION!)
|
|
```bash
|
|
cd D:\Hosted\familyhub
|
|
git push origin main --force
|
|
```
|
|
|
|
⚠️ **WARNING**: Force push will overwrite any commits in Gitea!
|
|
|
|
---
|
|
|
|
## 🔍 Check Status
|
|
|
|
After pushing, verify:
|
|
```bash
|
|
cd D:\Hosted\familyhub
|
|
git status
|
|
git log --oneline
|
|
```
|
|
|
|
Visit: https://gitea.hideawaygaming.com.au/jessikitty/family-hub
|
|
|
|
---
|
|
|
|
## 📋 Manual Push (If Script Fails)
|
|
|
|
```bash
|
|
cd D:\Hosted\familyhub
|
|
|
|
# Initialize
|
|
git init
|
|
|
|
# Configure
|
|
git config user.name "Jess"
|
|
git config user.email "jess.rogerson.29@outlook.com"
|
|
|
|
# Add remote
|
|
git remote add origin https://gitea.hideawaygaming.com.au/jessikitty/family-hub.git
|
|
|
|
# Add files
|
|
git add .
|
|
|
|
# Commit
|
|
git commit -m "Phase 3.1: Enhanced Chore Logging and Reporting System"
|
|
|
|
# Push
|
|
git branch -M main
|
|
git push -u origin main
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ Success Checklist
|
|
|
|
After successful push:
|
|
- [ ] Visit Gitea repository URL
|
|
- [ ] See all files listed
|
|
- [ ] Check commit message appears
|
|
- [ ] Verify README.md displays nicely
|
|
- [ ] Celebrate! 🎉
|
|
|
|
---
|
|
|
|
## 🆘 Still Having Issues?
|
|
|
|
1. Check if Gitea is accessible: https://gitea.hideawaygaming.com.au
|
|
2. Verify repository exists: https://gitea.hideawaygaming.com.au/jessikitty/family-hub
|
|
3. Ensure you have permissions to push
|
|
4. Try using SSH instead of HTTPS
|
|
|
|
---
|
|
|
|
## 📞 Need Help?
|
|
|
|
Just ask! I can help troubleshoot any issues.
|
|
|
|
---
|
|
|
|
_Git Setup & Push Guide_
|
|
_Date: February 4, 2026_
|