gnunet-handbook

The GNUnet Handbook
Log | Files | Refs

gtk.rst (3264B)


      1 .. _The-graphical-configuration-interface:
      2 
      3 The graphical configuration interface
      4 -------------------------------------
      5 
      6 .. Inserted from Installation Handbook in original "order".
      7 
      8 .. original FIXME said to move to the user's handbook...
      9    WGL thinks somewhere else...
     10 
     11 If you also would like to use ``gnunet-gtk`` and ``gnunet-setup``
     12 (highly recommended for beginners), do:
     13 
     14 .. _Configuring-your-peer:
     15 
     16 Configuring your peer
     17 ~~~~~~~~~~~~~~~~~~~~~
     18 
     19 This chapter will describe the various configuration options in GNUnet.
     20 
     21 The easiest way to configure your peer is to use the ``gnunet-setup``
     22 tool. ``gnunet-setup`` is part of the ``gnunet-gtk`` package. You might
     23 have to install it separately.
     24 
     25 Many of the specific sections from this chapter actually are linked from
     26 within ``gnunet-setup`` to help you while using the setup tool.
     27 
     28 While you can also configure your peer by editing the configuration file
     29 by hand, this is not recommended for anyone except for developers as it
     30 requires a more in-depth understanding of the configuration files and
     31 internal dependencies of GNUnet.
     32 
     33 .. _Configuration-of-the-HOSTLIST-proxy-settings:
     34 
     35 Configuration of the HOSTLIST proxy settings
     36 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     37 
     38 The hostlist client can be configured to use a proxy to connect to the
     39 hostlist server. This functionality can be configured in the
     40 configuration file directly or using the ``gnunet-setup`` tool.
     41 
     42 The hostlist client supports the following proxy types at the moment:
     43 
     44 -  HTTP and HTTP 1.0 only proxy
     45 
     46 -  SOCKS 4/4a/5/5 with hostname
     47 
     48 In addition authentication at the proxy with username and password can
     49 be configured.
     50 
     51 To configure proxy support for the hostlist client in the
     52 ``gnunet-setup`` tool, select the \"hostlist\" tab and select the
     53 appropriate proxy type. The hostname or IP address (including port if
     54 required) has to be entered in the \"Proxy hostname\" textbox. If
     55 required, enter username and password in the \"Proxy username\" and
     56 \"Proxy password\" boxes. Be aware that this information will be stored
     57 in the configuration in plain text (TODO: Add explanation and generalize
     58 the part in Chapter 3.6 about the encrypted home).
     59 
     60 .. _Configuration-of-the-HTTP-and-HTTPS-transport-plugins:
     61 
     62 Configuration of the HTTP and HTTPS transport plugins
     63 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     64 
     65 The client parts of the http and https transport plugins can be
     66 configured to use a proxy to connect to the hostlist server. This
     67 functionality can be configured in the configuration file directly or
     68 using the gnunet-setup tool.
     69 
     70 Both the HTTP and HTTPS clients support the following proxy types at the
     71 moment:
     72 
     73 -  HTTP 1.1 proxy
     74 
     75 -  SOCKS 4/4a/5/5 with hostname
     76 
     77 In addition authentication at the proxy with username and password can
     78 be configured.
     79 
     80 To configure proxy support for the clients in the gnunet-setup tool,
     81 select the \"transport\" tab and activate the respective plugin. Now you
     82 can select the appropriate proxy type. The hostname or IP address
     83 (including port if required) has to be entered in the \"Proxy hostname\"
     84 textbox. If required, enter username and password in the \"Proxy
     85 username\" and \"Proxy password\" boxes. Be aware that these information
     86 will be stored in the configuration in plain text.