doc/install.texi

   1 @node Install
   2 @cindex install
   3 @cindex packages
   4 @cindex ports
   5 @cindex tarball
   6 @cindex download
   7 @cindex PGP
   8 @unnumbered Install
   9
  10 Possibly @command{goredo} package already exists for your distribution:
  11 @itemize
  12 @item ALT Linux @url{http://www.sisyphus.ru/ru/srpm/Sisyphus/goredo, Sisyphus}
  13 @item Arch Linux @url{https://aur.archlinux.org/packages/goredo, AUR}
  14 @item Fedora @url{https://github.com/rpmsphere/source/tree/master/g, RPM Sphere}
  15 @item @url{https://www.freshports.org/devel/goredo/, FreeBSD ports}
  16 @item macOS @url{https://formulae.brew.sh/formula/goredo, Homebrew}
  17 @item @url{https://pkgsrc.se/devel/goredo, NetBSD package}
  18 @end itemize
  19
  20 Preferable way is to download tarball with the signature from website:
  21
  22 @example
  23 $ [fetch|wget] http://www.goredo.cypherpunks.ru/download/goredo-@value{VERSION}.tar.zst
  24 $ [fetch|wget] http://www.goredo.cypherpunks.ru/download/goredo-@value{VERSION}.tar.zst.sig
  25 $ gpg --verify goredo-@value{VERSION}.tar.zst.sig goredo-@value{VERSION}.tar.zst
  26 $ zstd -d < goredo-@value{VERSION}.tar.zst | tar xf -
  27 $ cd goredo-@value{VERSION}/src
  28 $ go build -mod=vendor
  29 $ ./goredo -symlinks        # create redo-* commands symlinks
  30 $ export PATH=`pwd`:$PATH   # let your system know about goredo
  31 @end example
  32
  33 @include download.texi
  34
  35 You @strong{have to} verify downloaded tarballs integrity and
  36 authenticity to be sure that you retrieved trusted and untampered
  37 software. @url{https://www.gnupg.org/, GNU Privacy Guard} is used
  38 for that purpose.
  39
  40 For the very first time it is necessary to get signing public key and
  41 import it. It is provided below, but you should check alternative
  42 resources.
  43
  44 @verbatim
  45 pub   ed25519/0x3A528DDE952C7E93 2021-01-09 [SC]
  46       7531BB84FAF0BF35960C63B93A528DDE952C7E93
  47 uid   goredo releases <goredo@cypherpunks.ru>
  48 @end verbatim
  49
  50 @itemize
  51
  52 @item
  53 @example
  54 $ gpg --auto-key-locate dane --locate-keys goredo at cypherpunks dot ru
  55 $ gpg --auto-key-locate wkd --locate-keys goredo at cypherpunks dot ru
  56 @end example
  57
  58 @item
  59 @verbatiminclude ../PUBKEY.asc
  60
  61 @end itemize
  62
  63 It is also @command{go get}-able:
  64
  65 @example
  66 $ go get go.cypherpunks.ru/goredo
  67 $ goredo -symlinks
  68 @end example
  69
  70 @vindex GOPRIVATE
  71 If you have problems with @code{*.golang.org}'s inability to verify
  72 authenticity of @code{go.cypherpunks.ru} TLS connection, then you can
  73 disable their usage by setting @env{$GOPRIVATE=go.cypherpunks.ru}. You
  74 can override CA certificate file path with @env{$SSL_CERT_FILE} and
  75 @env{$GIT_SSL_CAINFO} environment variables.
  76
  77 @cindex git
  78 You can obtain development source code with
  79 @command{git clone git://git.cypherpunks.ru/goredo.git}
  80 (also you can use @url{https://git.cypherpunks.ru/goredo.git}).