doc/installation.texi

   1 @node Installation
   2 @unnumbered Installation
   3
   4 GoVPN is written on @url{http://golang.org/, Go programming language},
   5 @url{https://www.gnu.org/software/make/, GNU Make} is recommended for
   6 convenient building. @url{https://www.gnu.org/software/texinfo/, Texinfo}
   7 is used for building documentation.
   8
   9 Required libraries, dependencies (they are installed automatically when
  10 using @emph{Make}):
  11
  12 @multitable @columnfractions .40 .20 .40
  13 @headitem Library @tab Platform @tab Licence
  14 @item @code{golang.org/x/crypto/poly1305} @tab All @tab BSD 3-Clause
  15 @item @code{golang.org/x/crypto/salsa20} @tab All @tab BSD 3-Clause
  16 @item @code{golang.org/x/crypto/xtea} @tab All @tab BSD 3-Clause
  17 @item @code{golang.org/x/crypto/pbkdf2} @tab All @tab BSD 3-Clause
  18 @item @code{github.com/agl/ed25519} @tab All @tab BSD 3-Clause
  19 @item @code{github.com/bigeagle/water} @tab GNU/Linux @tab BSD 3-Clause
  20 @end multitable
  21
  22 @include download.texi
  23
  24 You @strong{have to} verify downloaded archives integrity and check
  25 their signature to be sure that you have got trusted, untampered
  26 software. For integrity and authentication of downloaded binaries
  27 @url{https://www.gnupg.org/, The GNU Privacy Guard} is used. You must
  28 download signature provided with the tarball.
  29
  30 For the very first time you have to import signing public keys. They
  31 are provided below, but be sure that you are reading them from the
  32 trusted source. Alternatively check this page from
  33 @ref{Contacts, other sources} and look for the mailing list announcements.
  34
  35 For example you can get tarball, set proper @code{$GOPATH} and run
  36 @code{make} (that will install all necessary libraries and build
  37 @emph{govpn-client}, @emph{govpn-server}, @emph{govpn-verifier} binaries:
  38
  39 @example
  40 % mkdir -p govpn/src
  41 % set -e
  42 % wget http://www.cypherpunks.ru/govpn/download/govpn-2.3.tar.xz
  43 % wget http://www.cypherpunks.ru/govpn/download/govpn-2.3.tar.xz.sig
  44 % gpg --verify govpn-2.3.tar.xz.sig govpn-2.3.tar.xz
  45 % tar xfC govpn-2.3.tar.xz govpn/src
  46 % mv govpn/src/govpn-2.3 govpn/src/govpn
  47 % export GOPATH=$(pwd)/govpn:$GOPATH
  48 % gmake -C govpn/src/govpn all
  49 @end example
  50
  51 @include pubkey.texi