diff options
Diffstat (limited to 'README.txt')
-rw-r--r-- | README.txt | 108 |
1 files changed, 0 insertions, 108 deletions
diff --git a/README.txt b/README.txt deleted file mode 100644 index e65cdbe..0000000 --- a/README.txt +++ /dev/null | |||
@@ -1,108 +0,0 @@ | |||
1 | WHAT IT DOES | ||
2 | ------------ | ||
3 | |||
4 | This repository contains the code to share itself through Git-over-SSH. | ||
5 | |||
6 | It also contains the code to listen for changes sent to itself through | ||
7 | Git-over-SSH. | ||
8 | |||
9 | |||
10 | |||
11 | |||
12 | . | ||
13 | . | ||
14 | . | ||
15 | . | ||
16 | . | ||
17 | . | ||
18 | |||
19 | |||
20 | |||
21 | HOW IT WORKS | ||
22 | ------------ | ||
23 | |||
24 | Git contains a program `git-receive-pack` which implements a git protocol | ||
25 | server. The `git-receive-pack` expects to be launched as an SSH server | ||
26 | "ForcedCommand" in a configuration that protects the server from untrustworthy | ||
27 | users. | ||
28 | |||
29 | |||
30 | |||
31 | . | ||
32 | . | ||
33 | . | ||
34 | . | ||
35 | . | ||
36 | . | ||
37 | HOW TO INSTALL | ||
38 | -------------- | ||
39 | |||
40 | |||
41 | Run: | ||
42 | |||
43 | |||
44 | make | ||
45 | |||
46 | |||
47 | |||
48 | This installs the `AnonymousAccessCommand` in the current user's home directory. | ||
49 | |||
50 | Then, if sudo access is available, it enables anonymous access by editing the | ||
51 | system `OpenSSH` configuration. | ||
52 | |||
53 | |||
54 | |||
55 | . | ||
56 | . | ||
57 | . | ||
58 | . | ||
59 | . | ||
60 | . | ||
61 | |||
62 | |||
63 | |||
64 | NON-ROOT INSTALLATION | ||
65 | --------------------- | ||
66 | |||
67 | If sudo access is not available, you can install to a different location: | ||
68 | |||
69 | ``` | ||
70 | make SSH_CONFIG_DIR=.config/ssh \ | ||
71 | SSHD_CONFIG_DIR=.config/ssh/config.d \ | ||
72 | SSH_LIB_DIR=.local/lib/ssh | ||
73 | ``` | ||
74 | |||
75 | Then you will need to run `OpenSSH` on a non-default port (the default port | ||
76 | requires root access). | ||
77 | |||
78 | |||
79 | |||
80 | . | ||
81 | . | ||
82 | . | ||
83 | . | ||
84 | . | ||
85 | . | ||
86 | |||
87 | |||
88 | |||
89 | ALTERNATIVE LOCATION OF `AnonymousAccessCommand` | ||
90 | ------------------------------------------------ | ||
91 | |||
92 | It is also possible to choose the location of the `AnonymousAccessCommand` itself: | ||
93 | |||
94 | ``` | ||
95 | make USER_SSH_CONFIG_DIR=/.config/ssh | ||
96 | ``` | ||
97 | |||
98 | First you will have to make `AuthorizedKeysCommand` vary according to that | ||
99 | paremeter. | ||
100 | |||
101 | |||
102 | |||
103 | |||
104 | |||
105 | |||
106 | |||
107 | |||
108 | |||