NAME¶
gnunet-setup - a gtk interface for configuring GNUnet
SYNOPSIS¶
gnunet-setup [
OPTIONS]
DESCRIPTION¶
gnunet-setup is a gtk+ based GUI for configuring GNUnet.
The first time you run gnunet-setup, the goal will typically be to configure the
peer, that is, the set of processes that always run in the background. Those
processes should run as user "gnunet" and thus gnunet-setup should
be run as user "gnunet" for this step. Use the "-e" option
to enable automatic privilege escalation using gksu (if supported by your
system). Alternatively, you can of course run gnunet-setup from the
"gnunet" system user account or even as "root". If you see
a tab "General", you did start gnunet-setup correctly to configure
the peer. You should now be able to configure which subsystems of GNUnet you
want to enable, which databases to use and what your network configuration
looks like. After these steps are complete, you should be able to start your
peer using "gnunet-arm".
It is recommended that "/etc/gnunet.conf" should be a world-readable
copy of the peer's GNUnet configuration. Note that GNUnet configuration files
(as generated by gnunet-setup) only contain those values that differ from the
defaults. Also note that "gnunet-arm" will by default look for a
configuration in "$HOME/.config/gnunet.conf" (or,
"$XDG_CONFIG_DIR/gnunet.conf" if "$XDG_CONFIG_DIR" is
set); thus, if your configuration is in "/etc/gnunet.conf", you have
to pass "-c /etc/gnunet.conf" to gnunet-arm or set
"$XDG_CONFIG_DIR" to "/etc/".
- -a, --autoconfig
- try to automatically configure networking for the peer without starting
the interactive GUI
- -c FILENAME, --config=FILENAME
- load config file (default: ~/.config/gnunet.conf)
- -e, --elevate-privileges
- Try to elevate privileges to run gnunet-setup as user "gnunet".
This option is only available if libgksu-support was found on your system.
It is ignored if gnunet-setup is run as user "root" or
"gnunet" already. If "gksu" fails, gnunet-setup is run
as the current user.
- -h, --help
- print help page
- -v, --version
- print the version number
NOTES¶
Many options in gnunet-setup are documented online. Access the online help by
first selecting the respective widget and then clicking on the link at the
bottom of the dialog.
Exiting gnunet-setup (by closing the window or pressing ESCape) always saves the
current configuration to disk.
FILES¶
- ~/.config/gnunet.conf
- User's GNUnet configuration file
REPORTING BUGS¶
Report bugs by using mantis <
https://gnunet.org/bugs/> or by sending
electronic mail to <gnunet-developers@gnu.org>
SEE ALSO¶
gnunet-arm(1),
gnunet.conf(5)