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