summaryrefslogtreecommitdiffhomepage
path: root/INSTALL
blob: 3d6e3b3c9492d83ea2df54e284d8d8c366f03676 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
## Quick installation

This installs keysafe to ~/.local/bin, and is sufficient to use keysafe
to back up or restore your private key.

First install Haskell's stack tool, the zlib, g++, readline and argon2
libraries, and zenity. For example, on a Debian testing system:

	sudo apt-get install haskell-stack \
		zlib1g-dev g++ libreadline-dev libargon2-0-dev zenity

If your distribution does not yet include Haskell's stack tool,
see http://haskellstack.org/

Then to build and install keysafe, run this in the keysafe directory:

	stack install

Note that there is a manpage, but stack doesn't install it yet.

## System-wide installation

This installs keysafe in /usr/bin, and includes the man page, 
desktop file, autostart file, systemd service file, etc.

Start by installing the dependencies as shown in Quick installation.

Then, in the keysafe directory:

	make
	sudo make install

## Packaging

You will probably want to use the Makefile.
Set PREFIX to install to a different location.
Set BUILDER=cabal to use cabal rather than the default stack to build.

The make install target creates a keysafe user. Use the install-files
target to avoid doing that at package build time. You may create the
keysafe user at package install time instead, although it is only used
by the keysafe server.

While keysafe ships with a systemd service file, distributions should 
not enable it to be started by default. (Or can put it in its own
keysafe-server package.)