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 
13 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 and SHA256.sig to cryptographically verify the downloaded tarball.
14 ```
15 $ signify -Cp kamid-CURRV.pub -x SHA256.sig
16 Signature Verified
17 kamid-CURRV.pub: OK
18 kamid-CURRV.tar.gz: OK
19 kamid-NEXTV.pub: OK
20 ```
21 
22 The signify pubkeys for this and the next release are:
23 ```
24 kamid-CURRV.pub:	CURRSIGN
25 kamid-NEXTV.pub:	NEXTSIGN
26 ```
27 
28 Once the dependencies are installed, building is as easy as:
29 ```
30 $ tar xzf kamid-CURRV.tar.gz
31 $ cd kamid-CURRV.tar.gz
32 $ ./configure
33 $ make
34 # make install	# eventually
35 ```
36 
37 This should install a few programs:
38 
39 * kamid - the daemon itself
40 * kamictl - a comman-line utility to manage the daemon
41 * kamiftp - an ftp(1)-like 9p client
42 * kamiproxy - a proxy for clients that speak 9p in cleartext
43 
44 and the relative manpages.
45 
46 => tutorial.EXT		To set it up, proceed to the tutorial.