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