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