From e8c608c19859d5b9363eb58c46a140abb42557d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicol=C3=A1s=20Reynolds?= Date: Wed, 5 Sep 2012 13:40:45 -0300 Subject: Universal README --- README.markdown | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index de5eee6..bb721e2 100644 --- a/README.markdown +++ b/README.markdown @@ -1,5 +1,22 @@ -Parabola Hackers -================ +Hackers +======= + +## What's this? Why? + +Hackers is a simple git repository management tool. I started this for Parabola +GNU/Linux-libre when our gitosis broke and was never fixed. We didn't need +gitosis' granular permissions anyway. + +Hackers.git allows for decentralized management, since any hacker added can add +new keys, own and others'. + +It uses the git-shell to allow users to do git repository tasks (create a repo, +mirror one, etc.) using ssh to connect to the repository server. + +## Install + +Run `make PREFIX=/srv/git install` as root, where *PREFIX* is the git root. +Check the Makefile itself to see other options. ## How to add new keys @@ -20,8 +37,3 @@ privileges for the git user. 'git' is an unprivileged user. If you know how to skip this and gain access to our servers be kind and let us now ;) - -## Why? - -Gitosis broke once and was never fixed. We didn't need gitosis' granular -permissions anyway. Now Parabola hackers can add new hackers! -- cgit v1.2.3 From 47f7c9013487c0d148ace310c24e64708d7ec872 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicol=C3=A1s=20Reynolds?= Date: Sat, 8 Sep 2012 20:27:51 -0300 Subject: More README --- README.markdown | 30 +++++++++++++++++++++++++----- 1 file changed, 25 insertions(+), 5 deletions(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index bb721e2..328a518 100644 --- a/README.markdown +++ b/README.markdown @@ -15,17 +15,37 @@ mirror one, etc.) using ssh to connect to the repository server. ## Install -Run `make PREFIX=/srv/git install` as root, where *PREFIX* is the git root. -Check the Makefile itself to see other options. +Run `make PREFIX=/srv/git` as root, where *PREFIX* is the git root. Check the +Makefile itself to see other options. + +Now you can use `ssh git@host command arguments`, run the *help* command to +list commands and arguments available. + +## Host requirements + +You'll need `git-shell`, on Parabola it's on the *git* package. Also a working +ssh daemon with "AuthorizedKeysFile .ssh/authorized_keys" (default in most +installations). + +## Local configuration + +On your hacking user, you can add this to your *~/.ssh/config* + + Host git + HostName git_hostname_can_be_localhost + User git + +The repo URL will be *git:repo.git* or *ssh://gitPREFIX/repo.git*. ## How to add new keys -* Add your key to the authorized\_keys file. +* Add your key to the authorized\_keys file on your local clone * Change the key comment to the "Name " format (just for keeping it tidy) * Commit * Push if you have push privileges and you're adding a new hacker, or -* Run `git format-patch HEAD-1` and send the generated patches to Parabola +* Run `git format-patch HEAD-1` and send the generated patches to one of the + other hackers listed. ## How does this work? @@ -35,5 +55,5 @@ privileges for the git user. ## Is this insecure? -'git' is an unprivileged user. If you know how to skip this and gain access to +*git* is an unprivileged user. If you know how to skip this and gain access to our servers be kind and let us now ;) -- cgit v1.2.3 From 650750cae5039d1a0ece091fe84e7bd2a17eca00 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicol=C3=A1s=20Reynolds?= Date: Sun, 11 Nov 2012 21:17:08 -0300 Subject: Ensure we start with some pubkeys --- README.markdown | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 328a518..949f2d7 100644 --- a/README.markdown +++ b/README.markdown @@ -15,6 +15,12 @@ mirror one, etc.) using ssh to connect to the repository server. ## Install +Clone hackers.git somewhere and add yours and other people's SSH pubkeys (at +least yours) to the authorized\_keys file, then commit. + +This step can be done in a single step with `make bootstrap` (or let the next +step do it). If you don't you won't be able to login later! + Run `make PREFIX=/srv/git` as root, where *PREFIX* is the git root. Check the Makefile itself to see other options. -- cgit v1.2.3