1 # installation guide
2 
3 kamid has a short number of dependency, namely:
4 
5 * libtls
6 * libevent
7 * readline
8 
9 Sources can be fetched from:
10 
11 => GH/releases/download/CURRV/kamid-CURRV.tar.gz	kamid-CURRV.tar.gz
12 => GH/releases/download/CURRV/SHA256			SHA256
13 => GH/releases/download/CURRV/SHA256.sig		SHA256.sig
14 => GH/releases/download/CURRV/kamid-CURRV.pub		kamid-CURRV.pub
15 
16 It's strongly advised to verify the tarball before compiling.  A SHA256 file is provided, but it can only detect accidental corruption.  Instead, use signify(1) and SHA256.sig to cryptographically verify the downloaded tarball.
17 ```
18 $ signify -Cp kamid-CURRV.pub -x SHA256.sig
19 Signature Verified
20 kamid-CURRV.pub: OK
21 kamid-CURRV.tar.gz: OK
22 kamid-NEXTV.pub: OK
23 ```
24 
25 The signify pubkeys for this and the next release are:
26 ```
27 kamid-CURRV.pub:	CURRSIGN
28 kamid-NEXTV.pub:	NEXTSIGN
29 ```
30 
31 Once the dependencies are installed, building is as easy as:
32 ```
33 $ tar xzf kamid-CURRV.tar.gz
34 $ cd kamid-CURRV.tar.gz
35 $ ./configure
36 $ make
37 # make install	# eventually
38 ```
39 
40 This should install a few programs:
41 
42 * kamid - the daemon itself
43 * kamictl - a comman-line utility to manage the daemon
44 * kamiftp - an ftp(1)-like 9p client
45 * kamiproxy - a proxy for clients that speak 9p in cleartext
46 
47 and the relative manpages.
48 
49 => tutorial.EXT		To set it up, proceed to the tutorial.