diff options
Diffstat (limited to 'template')
-rw-r--r-- | template/about.html.j2 | 2 | ||||
-rw-r--r-- | template/gsoc-2018-gnunet-webui.html.j2 | 2 | ||||
-rw-r--r-- | template/gsoc.html.j2 | 2 | ||||
-rw-r--r-- | template/index.html.j2 | 2 | ||||
-rw-r--r-- | template/install-on-macos.html.j2 | 2 | ||||
-rw-r--r-- | template/install-on-ubuntu1804.html.j2 | 122 | ||||
-rw-r--r-- | template/tutorial.html.j2 | 2 | ||||
-rw-r--r-- | template/use.html.j2 | 2 |
8 files changed, 25 insertions, 111 deletions
diff --git a/template/about.html.j2 b/template/about.html.j2 index 409fe7a5..45ef9fcd 100644 --- a/template/about.html.j2 +++ b/template/about.html.j2 | |||
@@ -93,7 +93,7 @@ | |||
93 | </p> | 93 | </p> |
94 | <p> | 94 | <p> |
95 | {% trans %} | 95 | {% trans %} |
96 | You are most welcome to <a href="engage.html">get engaged into the conversation</a>, <a href="install.html">install GNUnet</a>, <a href="use.html">use it</a> and <a href="contribute.html">contribute</a> in various ways. | 96 | You are most welcome to <a href="engage.html">get engaged into the conversation</a>, <a href="install.html">install GNUnet</a>, <a href="use.html">use it</a> and <a href="engage.html">contribute and get engaged</a> in various ways. |
97 | {% endtrans %} | 97 | {% endtrans %} |
98 | </p> | 98 | </p> |
99 | <p> | 99 | <p> |
diff --git a/template/gsoc-2018-gnunet-webui.html.j2 b/template/gsoc-2018-gnunet-webui.html.j2 index c96b9965..ada000f4 100644 --- a/template/gsoc-2018-gnunet-webui.html.j2 +++ b/template/gsoc-2018-gnunet-webui.html.j2 | |||
@@ -55,7 +55,7 @@ | |||
55 | already merged into the gnunet.git repository | 55 | already merged into the gnunet.git repository |
56 | (<a href="https://gnunet.org/git/gnunet.git/">GNUnet Main Git</a>).<br /> | 56 | (<a href="https://gnunet.org/git/gnunet.git/">GNUnet Main Git</a>).<br /> |
57 | To use the new features, clone the repository | 57 | To use the new features, clone the repository |
58 | and follow the <a href="https://gnunet.org/installation">Installation</a> | 58 | and follow the <a href="https://gnunet.org/en/install.html">Installation</a> |
59 | on gnunet.org. Then, start the rest service with "gnunet-arm -i rest". | 59 | on gnunet.org. Then, start the rest service with "gnunet-arm -i rest". |
60 | {% endtrans %} | 60 | {% endtrans %} |
61 | </p> | 61 | </p> |
diff --git a/template/gsoc.html.j2 b/template/gsoc.html.j2 index 5104e516..5b5d5bcf 100644 --- a/template/gsoc.html.j2 +++ b/template/gsoc.html.j2 | |||
@@ -255,7 +255,7 @@ | |||
255 | Design and implementation | 255 | Design and implementation |
256 | of <a href="http://jsonapi.org/">REST APIs</a> that expose | 256 | of <a href="http://jsonapi.org/">REST APIs</a> that expose |
257 | the | 257 | the |
258 | <a href="https://gnunet.org/doxygen/modules.html">GNUnet API</a> | 258 | <a href="https://docs.gnunet.org/doxygen/modules.html">GNUnet API</a> |
259 | so that easy, hands-on development is | 259 | so that easy, hands-on development is |
260 | possible. Also, browser-based UIs will be much easier to | 260 | possible. Also, browser-based UIs will be much easier to |
261 | create on top of REST APIs. | 261 | create on top of REST APIs. |
diff --git a/template/index.html.j2 b/template/index.html.j2 index 5b4a98b7..204bb7f9 100644 --- a/template/index.html.j2 +++ b/template/index.html.j2 | |||
@@ -224,7 +224,7 @@ | |||
224 | get engaged into the conversation</a>, | 224 | get engaged into the conversation</a>, |
225 | <a href="https://gnunet.org/en/install.html">install GNUnet</a>, | 225 | <a href="https://gnunet.org/en/install.html">install GNUnet</a>, |
226 | <a href="https://gnunet.org/en/use.html">use it</a> and | 226 | <a href="https://gnunet.org/en/use.html">use it</a> and |
227 | <a href="https://gnunet.org/en/contribute.html">contribute</a>. <br> | 227 | <a href="https://gnunet.org/en/engage.html">contribute</a>. <br> |
228 | Be aware that this project is still in an early alpha stage when it comes | 228 | Be aware that this project is still in an early alpha stage when it comes |
229 | to software – its not an easy task to rewrite the whole Internet! | 229 | to software – its not an easy task to rewrite the whole Internet! |
230 | {% endtrans %} | 230 | {% endtrans %} |
diff --git a/template/install-on-macos.html.j2 b/template/install-on-macos.html.j2 index 7a56441f..2529adbe 100644 --- a/template/install-on-macos.html.j2 +++ b/template/install-on-macos.html.j2 | |||
@@ -36,7 +36,7 @@ | |||
36 | GNUnet has a number of services and features. | 36 | GNUnet has a number of services and features. |
37 | Please check <a href="https://docs.gnunet.org/">our documentation</a> | 37 | Please check <a href="https://docs.gnunet.org/">our documentation</a> |
38 | to learn how to use them. If you find anything odd or bugs, please | 38 | to learn how to use them. If you find anything odd or bugs, please |
39 | <a href="https://gnunet.org/bugs">let us know</a>. | 39 | <a href="https://bugs.gnunet.org">let us know</a>. |
40 | </p> | 40 | </p> |
41 | 41 | ||
42 | <h2>{{_("First steps")}}</h2> | 42 | <h2>{{_("First steps")}}</h2> |
diff --git a/template/install-on-ubuntu1804.html.j2 b/template/install-on-ubuntu1804.html.j2 index fb218110..157183d8 100644 --- a/template/install-on-ubuntu1804.html.j2 +++ b/template/install-on-ubuntu1804.html.j2 | |||
@@ -43,8 +43,8 @@ | |||
43 | Next we create a directory in our home directory where we store | 43 | Next we create a directory in our home directory where we store |
44 | the source code later. We should keep this directory after | 44 | the source code later. We should keep this directory after |
45 | installation because it contains Makefiles that can be used for | 45 | installation because it contains Makefiles that can be used for |
46 | uninstalling GNUnet again (see chapter *Uninstall GNUnet and its | 46 | uninstalling GNUnet again (see chapter <b>Uninstall GNUnet and its |
47 | dependencies*). | 47 | dependencies</b>). |
48 | </p> | 48 | </p> |
49 | <code> | 49 | <code> |
50 | $ mkdir ~/gnunet_installation | 50 | $ mkdir ~/gnunet_installation |
@@ -61,19 +61,20 @@ | |||
61 | <h2>{{ _("Compile and Install") }}</h2> | 61 | <h2>{{ _("Compile and Install") }}</h2> |
62 | <p> | 62 | <p> |
63 | Installing GNUnet is not hard. We have two options: | 63 | Installing GNUnet is not hard. We have two options: |
64 | installing a *production version* and installing a *development version*. If | 64 | installing a <b>production version</b> and installing a <b>development version</b>. If |
65 | you want to start writing GNUnet applications or join the GNUnet development | 65 | you want to start writing GNUnet applications or join the GNUnet development |
66 | choose the development version (it will print more debug output and contains | 66 | choose the development version (it will print more debug output and contains |
67 | debug symbols that can be displayed with a debugger). Otherwise choose the | 67 | debug symbols that can be displayed with a debugger). Otherwise choose the |
68 | production version. | 68 | production version. |
69 | </p> | 69 | </p> |
70 | <h3>{{ _("Option 1: GNUnet for production / usage") }}</h3> | 70 | <h3>{{ _("Option 1: GNUnet for testing / usage") }}</h3> |
71 | <code> | 71 | <code> |
72 | $ cd ~/gnunet_installation/gnunet<br> | 72 | $ cd ~/gnunet_installation/gnunet<br> |
73 | $ ./bootstrap<br> | 73 | $ ./bootstrap<br> |
74 | $ ./configure --prefix=$GNUNET_PREFIX --disable-documentation --with-microhttpd=/opt/libmicrohttpd<br> | 74 | $ ./configure --prefix=$GNUNET_PREFIX --disable-documentation --with-microhttpd=/opt/libmicrohttpd<br> |
75 | $ sudo addgroup gnunetdns<br> | 75 | $ sudo addgroup gnunetdns<br> |
76 | $ sudo adduser --system --group --disabled-login --home /var/lib/gnunet gnunet<br> | 76 | $ sudo adduser --system --group --disabled-login --home /var/lib/gnunet gnunet<br> |
77 | $ sudo usermod -aG gnunet $USER | ||
77 | $ make -j$(nproc || echo -n 1)<br> | 78 | $ make -j$(nproc || echo -n 1)<br> |
78 | $ sudo make install | 79 | $ sudo make install |
79 | </code> | 80 | </code> |
@@ -82,8 +83,11 @@ | |||
82 | <code> | 83 | <code> |
83 | $ cd ~/gnunet_installation/gnunet<br> | 84 | $ cd ~/gnunet_installation/gnunet<br> |
84 | $ ./bootstrap<br> | 85 | $ ./bootstrap<br> |
86 | $ export GNUNET_PREFIX=/usr/local # for example, other locations possible | ||
85 | $ export CFLAGS="-g -Wall -O0"<br> | 87 | $ export CFLAGS="-g -Wall -O0"<br> |
86 | $ ./configure --prefix=$GNUNET_PREFIX --disable-documentation --enable-logging=verbose <br> | 88 | $ ./configure --prefix=$GNUNET_PREFIX --disable-documentation --enable-logging=verbose <br> |
89 | $ sudo addgroup gnunet<br> | ||
90 | $ sudo usermod -aG gnunet $USER | ||
87 | $ make -j$(nproc || echo -n 1)<br> | 91 | $ make -j$(nproc || echo -n 1)<br> |
88 | $ sudo make install | 92 | $ sudo make install |
89 | </code> | 93 | </code> |
@@ -93,7 +97,7 @@ | |||
93 | So now it gets a bit nasty. It's not so bad. All we have to do is copy a file and edit another one. The file we need to copy is GNUnet's plugin for the Name Service Switch (NSS) in unix systems. Different unixes expect it in different locations and GNUnet's build system does not try to guess. On Ubuntu 18.04 we have to do | 97 | So now it gets a bit nasty. It's not so bad. All we have to do is copy a file and edit another one. The file we need to copy is GNUnet's plugin for the Name Service Switch (NSS) in unix systems. Different unixes expect it in different locations and GNUnet's build system does not try to guess. On Ubuntu 18.04 we have to do |
94 | 98 | ||
95 | <code> | 99 | <code> |
96 | $ sudo cp /usr/lib/gnunet/nss/libnss_gns.so.2 /lib/$(uname -m)-linux-gnu/ | 100 | $ sudo cp /usr/lib/gnunet/nss/libnss_gns.so.2 /lib/$(uname -m)-linux-gnu/ |
97 | </code> | 101 | </code> |
98 | 102 | ||
99 | <p>The next step is activating the GNUnet plugin we just copied in the NSS | 103 | <p>The next step is activating the GNUnet plugin we just copied in the NSS |
@@ -126,7 +130,7 @@ | |||
126 | 130 | ||
127 | <p>That's it. It wasn't that nasty, was it?</p> | 131 | <p>That's it. It wasn't that nasty, was it?</p> |
128 | --> | 132 | --> |
129 | <h2>{{ _("Configuration") }}</h2> | 133 | <h2>{{ _("Create configuration file") }}</h2> |
130 | 134 | ||
131 | <p> | 135 | <p> |
132 | Congratulations! GNUnet is now installed! Before we start it we | 136 | Congratulations! GNUnet is now installed! Before we start it we |
@@ -136,74 +140,23 @@ | |||
136 | </p> | 140 | </p> |
137 | <br /> | 141 | <br /> |
138 | <code> | 142 | <code> |
143 | $ mkdir -p ~/.config | ||
139 | $ touch ~/.config/gnunet.conf | 144 | $ touch ~/.config/gnunet.conf |
140 | </code> | 145 | </code> |
141 | <br /> | 146 | <br /> |
142 | <p> | ||
143 | It's reccomended that you increase your bandwidth restrictions | ||
144 | from the acutely low defaults. The example below sets the WAN | ||
145 | and LAN limits to the value "unlimited". | ||
146 | </p> | ||
147 | <br /> | ||
148 | <code> | ||
149 | $ gnunet-config -s ats -o WAN_QUOTA_IN -V unlimited<br /> | ||
150 | $ gnunet-config -s ats -o WAN_QUOTA_OUT -V unlimited<br /> | ||
151 | $ gnunet-config -s ats -o LAN_QUOTA_IN -V unlimited<br /> | ||
152 | $ gnunet-config -s ats -o LAN_QUOTA_OUT -V unlimited<br /> | ||
153 | </code> | ||
154 | <br /> | ||
155 | <p> | ||
156 | Now we can start it with the command line tool `gnunet-arm` | ||
157 | (Automatic Restart Manager). | ||
158 | </p> | ||
159 | |||
160 | <code> | ||
161 | $ gnunet-arm -s | ||
162 | </code> | ||
163 | 147 | ||
148 | |||
164 | <p> | 149 | <p> |
165 | It starts the default GNUnet services. We can list them with the `-I` option: | 150 | Now we created the configuration file. Please check the handbook for a first <a href="https://docs.gnunet.org/handbook/gnunet.html#Minimal-configuration">minimal configuration</a>. But in general, we dont need to configure anything in particular for now. |
166 | </p> | 151 | </p> |
167 | 152 | ||
168 | <code> | 153 | To go on, please <a href="https://gnunet.org/en/use.html">move over here</a>: |
169 | $ gnunet-arm -I<br> | ||
170 | Running services:<br> | ||
171 | ats (gnunet-service-ats)<br> | ||
172 | revocation (gnunet-service-revocation)<br> | ||
173 | set (gnunet-service-set)<br> | ||
174 | nat (gnunet-service-nat)<br> | ||
175 | transport (gnunet-service-transport)<br> | ||
176 | peerstore (gnunet-service-peerstore)<br> | ||
177 | hostlist (gnunet-daemon-hostlist)<br> | ||
178 | identity (gnunet-service-identity)<br> | ||
179 | namecache (gnunet-service-namecache)<br> | ||
180 | peerinfo (gnunet-service-peerinfo)<br> | ||
181 | datastore (gnunet-service-datastore)<br> | ||
182 | zonemaster (gnunet-service-zonemaster)<br> | ||
183 | zonemaster-monitor (gnunet-service-zonemaster-monitor)<br> | ||
184 | nse (gnunet-service-nse)<br> | ||
185 | cadet (gnunet-service-cadet)<br> | ||
186 | dht (gnunet-service-dht)<br> | ||
187 | core (gnunet-service-core)<br> | ||
188 | gns (gnunet-service-gns)<br> | ||
189 | statistics (gnunet-service-statistics)<br> | ||
190 | topology (gnunet-daemon-topology)<br> | ||
191 | fs (gnunet-service-fs)<br> | ||
192 | namestore (gnunet-service-namestore)<br> | ||
193 | vpn (gnunet-service-vpn) | ||
194 | </code> | ||
195 | 154 | ||
155 | <h2>{{ _("Use GNUnet!") }}</h2> | ||
156 | <p> | ||
157 | Please head over here: <a href="https://gnunet.org/en/use.html">Use!</a> | ||
196 | <p> | 158 | <p> |
197 | For stopping GNUnet again we can use the `-e` option. | ||
198 | </p> | ||
199 | 159 | ||
200 | <code> | ||
201 | $ gnunet-arm -e | ||
202 | </code> | ||
203 | <h2>{{ _("Use GNUnet!") }}</h2> | ||
204 | <p> | ||
205 | Please head over here: <a href="https://gnunet.org/en/use.html">Use!</a> | ||
206 | <p> | ||
207 | 160 | ||
208 | <h2>{{ _("Uninstall GNUnet and its dependencies") }}</h2> | 161 | <h2>{{ _("Uninstall GNUnet and its dependencies") }}</h2> |
209 | 162 | ||
@@ -221,46 +174,7 @@ | |||
221 | $ sudo rm /lib/$(uname -m)-linux-gnu/libnss_gns.so.2 | 174 | $ sudo rm /lib/$(uname -m)-linux-gnu/libnss_gns.so.2 |
222 | </code> | 175 | </code> |
223 | 176 | ||
224 | <h2>{{ _("Troubleshooting") }}</h2> | ||
225 | <h3>{{ _("You can't reach other people's nodes") }}</h3> | ||
226 | 177 | ||
227 | <p> | ||
228 | Should our computer not have reached the open GNUnet network automatically, | ||
229 | we can manually instruct our node how to reach the nodes of our friends. This | ||
230 | works by exchanging HELLO strings. This is how we get a hello string for our | ||
231 | computer. | ||
232 | </p> | ||
233 | |||
234 | <code> | ||
235 | $ gnunet-peerinfo -gn | ||
236 | </code> | ||
237 | |||
238 | <p> | ||
239 | We can now pass this string to our friends "out of band" (using whatever | ||
240 | existing chat or messaging technology). If the string contains some private IP | ||
241 | networks we don't want to share, we can carefully edit them out. | ||
242 | </p> | ||
243 | |||
244 | <p> | ||
245 | Once we receive such strings from our friends, we can add them like | ||
246 | this: | ||
247 | </p> | ||
248 | |||
249 | <code> | ||
250 | gnunet-peerinfo -p <string> | ||
251 | </code> | ||
252 | |||
253 | <p>Now our GNUnet nodes can attempt reaching each other directly. This may | ||
254 | still fail due to NAT traversal issues.</p> | ||
255 | |||
256 | <!--<h3>{{ _("OMG you guys broke my internet") }}</h3> | ||
257 | |||
258 | <p>We can replace `/etc/nsswitch.conf` with the backup we made earlier | ||
259 | (`/etc/nsswitch.conf.original`). Now DNS resolution should work again without a | ||
260 | running GNUnet.</p> | ||
261 | |||
262 | <code> | ||
263 | $ cp /etc/nsswitch.conf.original /etc/nsswitch.conf | ||
264 | </code>--> | ||
265 | </article> | 178 | </article> |
266 | {% endblock body_content %} | 179 | {% endblock body_content %} |
180 | |||
diff --git a/template/tutorial.html.j2 b/template/tutorial.html.j2 index f48c7feb..541def5c 100644 --- a/template/tutorial.html.j2 +++ b/template/tutorial.html.j2 | |||
@@ -30,7 +30,7 @@ | |||
30 | </p> | 30 | </p> |
31 | <p> | 31 | <p> |
32 | {% trans %} | 32 | {% trans %} |
33 | <a href="https://tutorial.gnunet.org/">C Coding Tutorial for GNUnet</a> | 33 | <a href="https://docs.gnunet.org/tutorial/gnunet-tutorial.html">C Coding Tutorial for GNUnet</a> |
34 | {% endtrans %} | 34 | {% endtrans %} |
35 | </p> | 35 | </p> |
36 | <p> | 36 | <p> |
diff --git a/template/use.html.j2 b/template/use.html.j2 index 9c014036..1aa0ecad 100644 --- a/template/use.html.j2 +++ b/template/use.html.j2 | |||
@@ -205,7 +205,7 @@ | |||
205 | </code> | 205 | </code> |
206 | </p> | 206 | </p> |
207 | <p> | 207 | <p> |
208 | If you are interested into CADET in detail, please have a look in the <a href="https://docs.gnunet.org/handbook/gnunet.html/CADET-Subsystem.html#CADET-Subsystem ">chapter "Cadet-Subsystem" in our handbook</a>. The CADET subsystem is responsible for secure end-to-end communications between nodes in the GNUnet overlay network; as transport protocol it's somewhat of the heart of the project. | 208 | If you are interested into CADET in detail, please have a look in the <a href="https://docs.gnunet.org/handbook/gnunet.html#CADET-Subsystem">chapter "Cadet-Subsystem" in our handbook</a>. The CADET subsystem is responsible for secure end-to-end communications between nodes in the GNUnet overlay network; as transport protocol it's somewhat of the heart of the project. |
209 | </p> | 209 | </p> |
210 | </section> | 210 | </section> |
211 | 211 | ||