diff options
author | Nicolás Reynolds <fauno@endefensadelsl.org> | 2013-12-27 20:09:16 -0300 |
---|---|---|
committer | Nicolás Reynolds <fauno@endefensadelsl.org> | 2013-12-27 20:09:16 -0300 |
commit | 36537a04baaa5c6d7e4d6acc6924231d55a95b01 (patch) | |
tree | cd4402474d8f536192bc49eec6bebc0e7f5d77fe /README.markdown | |
parent | ff8ae8ceba55a43cfb5f763f75d9679c31c38a63 (diff) | |
parent | 76571cb2dc2644e9eb23758cd8da6d281d573994 (diff) |
Merge git://repo.hackcoop.com.ar/hacking
Conflicts:
authorized_keys
parabola-keyring/Makefile
parabola-keyring/packager-keyids
parabola-keyring/packager/aurelien.asc
parabola-keyring/packager/brendan.asc
parabola-keyring/packager/coadde.asc
parabola-keyring/packager/emulatorman.asc
parabola-keyring/packager/encyclomundi.asc
parabola-keyring/packager/fauno.asc
parabola-keyring/packager/jorginho.asc
parabola-keyring/packager/lukeshu.asc
parabola-keyring/packager/mtjm.asc
parabola-keyring/packager/ovruni.asc
parabola-keyring/packager/shackra.asc
parabola-keyring/packager/smv.asc
parabola-keyring/packager/xihh.asc
parabola-keyring/parabola-trusted
parabola-keyring/parabola.gpg
parabola-keyring/update-keys
Diffstat (limited to 'README.markdown')
-rw-r--r-- | README.markdown | 58 |
1 files changed, 48 insertions, 10 deletions
diff --git a/README.markdown b/README.markdown index de5eee6..949f2d7 100644 --- a/README.markdown +++ b/README.markdown @@ -1,14 +1,57 @@ -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 + +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. + +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 <name@email.nu>" 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? @@ -18,10 +61,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 ;) - -## Why? - -Gitosis broke once and was never fixed. We didn't need gitosis' granular -permissions anyway. Now Parabola hackers can add new hackers! |