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