From 7aafd4cdd8ac87fd4c7c56277fda32a084258ec3 Mon Sep 17 00:00:00 2001 From: Geir Okkenhaug Jerstad Date: Sat, 7 Jun 2025 16:46:09 +0000 Subject: [PATCH] docs: Add Forgejo Git configuration instructions - Correct SSH URL format: forgejo@git.geokkjer.eu:1337 - Document SSH port forwarding setup (1337 -> grey-area:22) - Add remote configuration examples - Clarify primary vs backup repository roles --- instruction.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/instruction.md b/instruction.md index 8fe4345..56bde4a 100644 --- a/instruction.md +++ b/instruction.md @@ -89,6 +89,19 @@ Home-lab/ - **Status monitoring**: Use `lab status` to get overview of all lab machines - **Document Context7 findings** in commit messages +### Git/Forgejo Configuration +- **Primary repository**: Hosted on self-hosted Forgejo instance +- **Forgejo URL**: `ssh://forgejo@git.geokkjer.eu:1337/geir/Home-lab.git` +- **SSH port**: 1337 (proxied through reverse-proxy to grey-area:22) +- **User**: Must use `forgejo` user, not `git` user +- **GitHub mirror**: `git@github.com:geokkjer/Home-lab.git` (secondary/backup) +- **Remote configuration**: + ```bash + git remote add origin ssh://forgejo@git.geokkjer.eu:1337/geir/Home-lab.git + git remote add github git@github.com:geokkjer/Home-lab.git + ``` +- **Pushing**: Primary pushes to Forgejo origin, manual sync to GitHub as needed + ## Key Constraints - **No Home Manager**: Use org-mode literate dotfiles instead - **ZFS preservation**: Never change hostId or break ZFS mounts