homarr-dashboard/SETUP_GITEA.md

🔗 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:

# 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:

# 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:

cd /opt/homelab/homarr-dashboard
./update.sh

Or manually:

cd /opt/homelab/homarr-dashboard
git pull
docker compose pull
docker compose up -d

---

📝 Making Changes

Local Development

# 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

# 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:

git config --global credential.helper cache
# Or store (less secure):
# git config --global credential.helper store

For SSH, ensure your key is added:

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:

# Rename local branch
git branch -m main

# Push
git push -u origin main