From 1f21a416c388be9586a08ca9fdf55e2ac4c25414 Mon Sep 17 00:00:00 2001
From: ImpulsiveFPS <roberthrajala@gmail.com>
Date: Tue, 3 Feb 2026 10:45:41 +0100
Subject: [PATCH] Add Gitea connection guide

---
 SETUP_GITEA.md | 157 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 157 insertions(+)
 create mode 100644 SETUP_GITEA.md

diff --git a/SETUP_GITEA.md b/SETUP_GITEA.md
new file mode 100644
index 0000000..fd352d1
--- /dev/null
+++ b/SETUP_GITEA.md
@@ -0,0 +1,157 @@
+# 🔗 Connect to Gitea Repository
+
+## Step 1: Create Repository in Gitea
+
+1. Go to `https://gitea.lemonlink.eu`
+2. Create organization: `homelab` (if not exists)
+3. Create repository: `homarr-dashboard`
+4. **Do NOT initialize with README** (we already have one)
+
+## Step 2: Add Remote and Push
+
+Run these commands from the `homarr-deploy` directory:
+
+```bash
+# HTTPS (easier, requires username/password)
+git remote add origin https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
+
+# OR SSH (requires SSH key setup)
+# git remote add origin git@gitea.lemonlink.eu:homelab/homarr-dashboard.git
+
+# Push to Gitea
+git push -u origin master
+# OR if Gitea uses 'main' as default:
+# git push -u origin main
+```
+
+## Step 3: Verify
+
+Check your Gitea repository at:
+`https://gitea.lemonlink.eu/homelab/homarr-dashboard`
+
+You should see all files: README.md, docker-compose.yml, config/, etc.
+
+---
+
+## 🚀 Deploy on Your Server
+
+SSH into your server and run:
+
+```bash
+# 1. Create directory
+mkdir -p /opt/homelab
+cd /opt/homelab
+
+# 2. Clone from Gitea
+git clone https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
+# OR with SSH:
+# git clone git@gitea.lemonlink.eu:homelab/homarr-dashboard.git
+
+cd homarr-dashboard
+
+# 3. Configure environment
+cp .env.example .env
+nano .env  # Edit with your domain, secrets, etc.
+
+# 4. Ensure NPM network exists
+docker network create npm-network 2>/dev/null || echo "Network already exists"
+
+# 5. Deploy
+chmod +x deploy.sh
+./deploy.sh
+```
+
+---
+
+## 🔄 Future Updates
+
+To update your deployment:
+
+```bash
+cd /opt/homelab/homarr-dashboard
+./update.sh
+```
+
+Or manually:
+
+```bash
+cd /opt/homelab/homarr-dashboard
+git pull
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## 📝 Making Changes
+
+### Local Development
+
+```bash
+# Edit files locally
+cd homarr-deploy
+# ... make changes ...
+
+# Commit and push
+git add .
+git commit -m "Description of changes"
+git push origin master
+
+# Then on server, pull and update
+ssh user@your-server
+cd /opt/homelab/homarr-dashboard
+./update.sh
+```
+
+### Using Gitea Web Interface
+
+1. Edit files directly in Gitea
+2. Commit changes
+3. On server, run: `./update.sh`
+
+---
+
+## 🆘 Troubleshooting
+
+### Issue: Cannot push to Gitea
+
+```bash
+# Check remote
+git remote -v
+
+# If wrong, remove and re-add
+git remote remove origin
+git remote add origin https://gitea.lemonlink.eu/homelab/homarr-dashboard.git
+
+# Try push with verbose
+git push -v origin master
+```
+
+### Issue: Authentication failed
+
+For HTTPS, you need to enter your Gitea username and password.
+
+To cache credentials:
+```bash
+git config --global credential.helper cache
+# Or store (less secure):
+# git config --global credential.helper store
+```
+
+For SSH, ensure your key is added:
+```bash
+cat ~/.ssh/id_rsa.pub
+# Copy and paste to Gitea → User Settings → SSH Keys
+```
+
+### Issue: Branch name mismatch
+
+If Gitea uses `main` but local is `master`:
+
+```bash
+# Rename local branch
+git branch -m main
+
+# Push
+git push -u origin main
+```