doc/installation.texi

   1 @node Installation
   2 @unnumbered Installation
   3
   4 GoVPN is written on Go programming language, But
   5 @url{https://www.gnu.org/software/make/, Make} program is recommended
   6 also to be used. @url{https://www.gnu.org/software/texinfo/, Texinfo} is
   7 used for building documentation. Also it depends on
   8 @code{golang.org/x/crypto} Go libraries.
   9
  10 @include download.texi
  11
  12 You @strong{have to} verify downloaded archives integrity and check
  13 their signature to be sure that you have got trusted, untampered
  14 software. For integrity and authentication of downloaded binaries
  15 @url{https://www.gnupg.org/, The GNU Privacy Guard} is used. You must
  16 download signature provided with the tarball and run for example:
  17
  18 @example
  19 gpg --verify govpn-1.5.tar.xz.sig govpn-1.5.tar.xz
  20 @end example
  21
  22 For the very first time you must also import signing public keys. They
  23 are provided below, but be sure that you are reading them from the
  24 trusted source. Alternatively check this page from other sources and
  25 look for the mailing list announcements.
  26
  27 You have to set up @code{$GOPATH} properly first. For example you can
  28 clone the repository or decompress tarball and set path like this:
  29
  30 @example
  31 % mkdir -p govpn/src
  32 % git clone https://github.com/stargrave/govpn.git govpn/src/govpn
  33 or
  34 % tar xfC govpn-1.5.tar.xz govpn/src && mv govpn/src/govpn-1.5 govpn/src/govpn
  35 % export GOPATH=$(pwd)/govpn:$GOPATH
  36 @end example
  37
  38 After that you can just type @code{make} and all necessary Go libraries
  39 will be installed and client/server binaries are built in the current
  40 directory:
  41
  42 @example
  43 % cd govpn/src/govpn
  44 % make
  45 [or gmake under FreeBSD]
  46 @end example
  47
  48 @include pubkey.texi