aboutsummaryrefslogtreecommitdiff
path: root/template/install.html.j2
blob: a975124c0d25d7cb474b3e2eea35099d23d815db (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
{% extends "common/base.j2" %}
{% block body_content %}
<article class="container">

  <header>
    <h1>{{ _("Install") }}</h1>
  </header>

  <div class="row container justify-content-center">
    <div class="alert alert-info">
{% trans %}
          Notice: GNUnet is still undergoing major development. It is
          largely <i>not yet ready</i> for usage beyond developers.
{% endtrans %}
    </div>
{% trans %}
<p>Please be aware that this project is still in an early alpha
stage when it comes to running software &#8211; its not an easy task
to rewrite the whole Internet! We are happy to get your
<a href="engage.html">helping hand</a> anytime!
Further information is available in our <a href="https://docs.gnunet.org/#toc-Using-GNUnet-1">handbook</a>.
If you have any queries about the installation or the usage, please <a href="engage.html">get in touch!</a></p>
{% endtrans %}
  </div>

  <h3>Binary packages</h3><br/>
  <p>
    {% trans %}
    We recommend to use binary packages provided by the package manager integrated
    within your Operating System. GNUnet is reportedly available for at least:
    <ul>
      <li><a href="https://pkgs.alpinelinux.org/package/edge/testing/x86_64/gnunet">Alpine</a></li>
      <li><a href="https://aur.archlinux.org/packages/gnunet/">Arch (AUR)</a></li>
      <li><a href="https://packages.debian.org/search?keywords=gnunet">Debian</a></li>
      <li><a href="https://copr.fedorainfracloud.org/coprs/yosl/gnunet/">Fedora (Copr)</a></li>
      <li><a href="https://guix.gnu.org/en/packages/G/">Guix</a></li>
      <li><a href="https://github.com/Homebrew/homebrew-core/blob/master/Formula/gnunet.rb">Homebrew</a></li>
      <li><a href="https://search.nixos.org/packages?from=0&size=50&sort=relevance&query=gnunet">NixOS</a></li>
      <li><a href="install-on-openwrt.html">OpenWrt</a></li>
    </ul>
    If GNUnet is available for your Operating System and it is missing,
    send us feedback so that we can add it to this list. Furthermore, if
    you are interested in packaging GNUnet for your Operating System,
    get in touch with us at gnunet-developers@gnu.org if you require
    help with this job.

    If you were using an Operating System with the APT package manager,
    GNUnet could be installed as simple as:
    {% endtrans %}
  </p>
  <code class="block">
    $ apt-get install gnunet
  </code>
  <p>
   Please beware that some distributions may include outdated GNUnet packages!
  </p>
  <h3>From source</h3>
  <p>
    {% trans %}
    Next we describe a generic way to install from source. If you are using
    one of the following Operating Systems these step-by-step guides might
    be useful:
    <a href="install-on-archpi.html">ArchPi</a>, 
    <a href="install-on-debian9.html">Debian 9</a>, 
    <a href="install-on-macos.html">Mac OS</a>, 
    <a href="install-on-netbsd.html">NetBSD</a>, 
    <a href="install-on-ubuntu1804.html">Ubuntu 1804</a>.
    Be aware that not all of them might be totally up-to-date! Please <a href="engage.html">ask us</a>
     if you get stuck.
    {% endtrans %}
  </p>
  <p>
    {% trans %}
    First, install the <a href="https://git.gnunet.org/gnunet.git/tree/README">required dependencies</a> of GNUnet. There are base requirements and optional
    requirements.
    {% endtrans %}
  </p>
  <p>
    {% trans %}
    Now, you need to decide if you want to install GNUnet from the release
    tarball or from git. If you want to use GNUnet and there is no binary
    package available for your OS, you should stick with the release tarball.
    If you want to develop using the most recent build, you should go with
    the <a href="https://git.gnunet.org/">git repository</a>.
    {% endtrans %}
  </p>
  <p>The current release tarballs for gnunet, a Gtk UI and fuse extensions can be found here:</p>
  <div class="row container justify-content-center">
    <div class="col-md">
    <b>gnunet</b>: <a href="http://ftpmirror.gnu.org/gnunet/gnunet-latest.tar.gz">Download</a> (<a href="http://ftpmirror.gnu.org/gnunet/gnunet-latest.tar.gz.sig">sig</a>)<br>
    <b>gnunet-gtk</b>: <a href="http://ftpmirror.gnu.org/gnunet/gnunet-gtk-latest.tar.gz">Download</a> (<a href="http://ftpmirror.gnu.org/gnunet/gnunet-gtk-latest.tar.gz.sig">sig</a>)<br/>
    <b>gnunet-fuse</b>: <a href="http://ftpmirror.gnu.org/gnunet/gnunet-fuse-latest.tar.gz">Download</a> (<a href="http://ftpmirror.gnu.org/gnunet/gnunet-fuse-latest.tar.gz.sig">sig</a>)
    </div>
  </div>
  <p>
   {% trans %}
   To compile gnunet from the git source you can do so by entering:
   {% endtrans %}
  </p>
  <code class="block">
    $ git clone https://git.gnunet.org/git/gnunet.git
  </code>
  <p>
   {% trans %}
   Before building GNUnet, make sure that you setup the required groups and
   add your user to the group <code>gnunet</code>:
   {% endtrans %}
  </p>
  <code class="block">
    # addgroup gnunetdns <br>
    # adduser --system --home "/var/lib/gnunet" --group gnunet --shell /bin/sh gnunet<br>
    # usermod -a -G gnunet &lt;username&gt;
  </code>
  <p>
   {% trans %}
   To compile GNUnet, execute:
   {% endtrans %}
  </p>
  <code class="block">
    $ export GNUNET_PREFIX=/usr/local/lib # or other directory of your choice<br>
    $ ./bootstrap # only if you install from git <br>
    $ ./configure --prefix=$GNUNET_PREFIX/.. <br>
    $ make
  </code>
  <p>
    {% trans %}
    You can find more configuration flags in the
    <a href="https://git.gnunet.org/gnunet.git/tree/README">README</a>.<br>
    Install GNUnet with:
    {% endtrans %}
  </p>
  <code class="block">
    $ (sudo) make install # you only need sudo if your GNUNET_PREFIX is not writeable by your user
  </code>
  <p>
    {% trans %}
    You can now start GNUnet by running:
    {% endtrans %}
  </p>
  <code class="block">
    $ gnunet-arm -s
  </code>
  <p>
    {% trans %}
    Check the <a href="https://docs.gnunet.org/handbook/gnunet.html#Minimal-configuration">handbook</a> for detailed documentation.
    For a more hands-on experience, <a href="https://gnunet.org/en/use.html">continue here</a>.
    {% endtrans %}
  </p>


<!--
  <div class="row container justify-content-center text-center">
    <div class="col-md">
      <p><a href="install-on-ubuntu1804.html"><img src="{{ url('images/ubuntu-logo32.png') }}" class="distro-logo"></a></p>
      <h3>Ubuntu 18.04</h3>
    </div>
    <div class="col-md">
      <p><a href="install-on-debian9.html"><img src="{{ url('images/debian-logo.svg') }}" class="distro-logo"></a></p>
      <h3>Debian 9</h3>
    </div>
    <div class="col-md">
      <p><a href="install-on-netbsd.html"><img src="{{ url('images/NetBSD_Logo.svg') }}" class="distro-logo"></a></p>
      <h3>NetBSD</h3>
    </div>
  </div>

  <div class="row container justify-content-center text-center">
    <div class="col-md">
      <h1><a href="install-on-macos.html">Apple<br/>macOS</a></h1>
    </div>
    <div class="col-md">
      <p><a href="install-on-archpi.html"><img src="{{ url('images/archlinux-logo.svg') }}" class="distro-logo" style="width:300px;height:auto"></a></p>
      <h3>Arch Linux/Arch-Pi</h3>
    </div>
    <div class="col-md">
      <p><a href="install-on-openwrt.html"><img src ="{{ url('images/openwrt-logo.svg') }}" class="distro-logo" style="width:300px;height:auto"></a></p>
      <h3>OpenWrt</h3>
    </div>
    <div class="col-md">
      <p><a href="https://wiki.gentoo.org/wiki/Overlay:Youbroketheinternet"><img alt="gentoo linux" src ="{{ url('images/gentoo-logo.svg') }}" class="distro-logo" style="width:170px;height:auto"></a></p>
    </div>
  </div>
-->
</article>
{% endblock body_content %}