diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 56 |
1 files changed, 38 insertions, 18 deletions
@@ -19,17 +19,23 @@ https://gnunet.org/. | |||
19 | Dependencies: | 19 | Dependencies: |
20 | ============= | 20 | ============= |
21 | 21 | ||
22 | For the impatient, here is the list of immediate dependencies for | 22 | Please note that for many of its dependencies GNUnet requires very |
23 | running GNUnet: | 23 | recent versions of the libraries which are often NOT to be found in |
24 | stable distributions in 2010. While using older packages may in some | ||
25 | cases on some operating systems may seem to work in some limited | ||
26 | fashion, we are in many cases aware of serious problems with older | ||
27 | packages. Hence please make sure to use the versions listed below. | ||
28 | |||
29 | These are the direct dependencies for running GNUnet: | ||
24 | 30 | ||
25 | - libextractor >= 0.6.1 | 31 | - libextractor >= 0.6.1 |
26 | - libmicrohttpd >= 0.4.6 | 32 | - libmicrohttpd >= 0.9.0 |
27 | - libgcrypt >= 1.2 | 33 | - libgcrypt >= 1.2 |
28 | - libgmp >= 4.0 | 34 | - libgmp >= 4.0 |
29 | - libcurl >= 7.15.4 | 35 | - libcurl >= 7.21.0 |
30 | - libltdl >= 2.2 (part of GNU libtool) | 36 | - libltdl >= 2.2 (part of GNU libtool) |
31 | - sqlite >= 3.0 (alternative to MySQL) | 37 | - sqlite >= 3.0 (alternative to MySQL) |
32 | - mysql >= ??? (not yet supported) | 38 | - mysql >= 5.1 (alternative to sqLite) |
33 | - postgres >= ??? (not yet supported) | 39 | - postgres >= ??? (not yet supported) |
34 | 40 | ||
35 | Recommended autotools for compiling the SVN version are: | 41 | Recommended autotools for compiling the SVN version are: |
@@ -37,8 +43,6 @@ Recommended autotools for compiling the SVN version are: | |||
37 | - automake >= 1.11.1 | 43 | - automake >= 1.11.1 |
38 | - libtool >= 2.2 | 44 | - libtool >= 2.2 |
39 | 45 | ||
40 | See also README.debian for a list of Debian packages. | ||
41 | |||
42 | 46 | ||
43 | How to install? | 47 | How to install? |
44 | =============== | 48 | =============== |
@@ -47,6 +51,12 @@ The fastest way is to use a binary package if it is available for your | |||
47 | system. For a more detailed description, read the installation | 51 | system. For a more detailed description, read the installation |
48 | instructions on the webpage at https://gnunet.org/installation. | 52 | instructions on the webpage at https://gnunet.org/installation. |
49 | 53 | ||
54 | Note that some functions of GNUnet require "root" access. GNUnet will | ||
55 | install (tiny) SUID binaries for those functions is you run "make | ||
56 | install" as root. If you do not, GNUnet will still work, but some | ||
57 | functionality will not be available (including certain forms of NAT | ||
58 | traversal). | ||
59 | |||
50 | GNUnet requires the GNU MP library (http://www.gnu.org/software/gmp/) | 60 | GNUnet requires the GNU MP library (http://www.gnu.org/software/gmp/) |
51 | and libgcrypt (http://www.gnupg.org/). You can specify the path to | 61 | and libgcrypt (http://www.gnupg.org/). You can specify the path to |
52 | libgcrypt by passing "--with-gcrypt=PATH" to configure. You will also | 62 | libgcrypt by passing "--with-gcrypt=PATH" to configure. You will also |
@@ -195,20 +205,30 @@ testcase to the Mantis bugtracking system at | |||
195 | https://gnunet.org/bugs/. | 205 | https://gnunet.org/bugs/. |
196 | 206 | ||
197 | 207 | ||
198 | Running http on port 80 | 208 | Running http on port 80 and https on port 443 |
199 | ======================= | 209 | ============================================= |
200 | 210 | ||
201 | In order to hide GNUnet's HTTP traffic perfectly, you might consider | 211 | In order to hide GNUnet's HTTP/HTTPS traffic perfectly, you might |
202 | running GNUnet's HTTP transport on port 80. However, we do not | 212 | consider running GNUnet's HTTP/HTTPS transport on port 80/443. |
203 | recommend running GNUnet as root. Instead, forward port 80 to say | 213 | However, we do not recommend running GNUnet as root. Instead, forward |
204 | 8080 with this command (as root, in your startup scripts): | 214 | port 80 to say 8080 with this command (as root, in your startup |
215 | scripts): | ||
205 | 216 | ||
206 | # iptables -t nat -A PREROUTING -p tcp -m tcp --dport 80 -j REDIRECT --to-ports 8080 | 217 | # iptables -t nat -A PREROUTING -p tcp -m tcp --dport 80 -j REDIRECT --to-ports 8080 |
207 | 218 | ||
208 | Then set in the HTTP section of gnunet.conf the "ADVERTISED-PORT" | 219 | or for HTTPS |
209 | to "80" and "PORT" to 8080. You can do the same trick for the | 220 | |
210 | TCP and UDP transports if you want to map them to a priviledged | 221 | # iptables -t nat -A PREROUTING -p tcp -m tcp --dport 443 -j REDIRECT --to-ports 4433 |
211 | port (from the point of view of the network). | 222 | |
223 | Then set in the HTTP section of gnunet.conf the "ADVERTISED-PORT" to | ||
224 | "80" and "PORT" to 8080 and similarly in the HTTPS section the | ||
225 | "ADVERTISED-PORT" to "443" and "PORT" to 4433. | ||
226 | |||
227 | You can do the same trick for the TCP and UDP transports if you want | ||
228 | to map them to a priviledged port (from the point of view of the | ||
229 | network). However, we are not aware of this providing any advantages | ||
230 | at this point. | ||
231 | |||
212 | 232 | ||
213 | 233 | ||
214 | Running the SMTP transport | 234 | Running the SMTP transport |
@@ -218,7 +238,7 @@ Running the SMTP transport | |||
218 | Running GNUnet over SMTP (e-mail) is a bit more involved. Note that | 238 | Running GNUnet over SMTP (e-mail) is a bit more involved. Note that |
219 | you do not need to run all transports (only running the NAT transport | 239 | you do not need to run all transports (only running the NAT transport |
220 | is the only thing that will not work). If you really want to do | 240 | is the only thing that will not work). If you really want to do |
221 | P2P over SMTP, read the instructions at http://gnunet.org/smtp.php3 | 241 | P2P over SMTP, read the instructions at http://gnunet.org/smtp |
222 | 242 | ||
223 | 243 | ||
224 | Stay tuned | 244 | Stay tuned |