doc/install.texi

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