doc/install.texi

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