gnunet-arm - control GNUnet services

GNUNET-ARM(1) General Commands Manual GNUNET-ARM(1)


gnunet-arm — control GNUnet services


gnunet-arm [−c FILENAME −-config=FILENAME] [−d −-delete] [−e −-end] [−E −-no-stderr] [−h −-help] [−i SERVICE −-init=SERVICE] [−I −-info] [−k SERVICE −-kill=SERVICE] [−l FILENAME −-logfile=FILENAME] [−L LOGLEVEL −-loglevel=LOGLEVEL] [−m −-monitor] [−O −-no-stdout] [−q −-quiet] [−r −-restart] [−s −-start] [−T −DELAY −-timeout=TIMEOUT] [−v −-version]


gnunet-arm can be used to start or stop GNUnet services, including the ARM service itself. The ARM service is a supervisor for GNUnet’s service processes. ARM starts services on-demand or as configured and restarts them if they crash.


Use the configuration file FILENAME.

−d | −-delete

Delete configuration file and directory on exit.

−e | −-end

Shutdown all GNUnet services (including ARM itself). Running "gnunet-arm -e" is the usual way to shutdown a GNUnet peer.

−E | −-no-stderr

Don’t let gnunet-arm inherit stderr (standard error).

−h | −-help

Print short help on options.


Starts the specified SERVICE if it is not already running. More specifically, this makes the service behave as if it were in the default services list.

−I | −-info

List all running services.


Stop SERVICE if it is running. While this will kill the service right now, the service may be restarted immediately if other services depend on it (the service is then started ’on-demand’). If the service used to be a ’default’ service, its default-service status will be revoked. If the service was not a default service, it will just be (temporarily) stopped, but could be re-started on-demand at any time.

−l FILENAME | −-logfile=FILENAME

Write logs to FILENAME.


Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.

−m | −-monitor

Monitor service activity of ARM. In this mode, the command will not terminate until the user presses CTRL-C (thus sending SIGTERM or SIGINT).

−O | −-no-stdout

Don’t let gnunet-arm inherit standard output

−q | −-quiet

Don’t print status messages.

−r | −-restart

Stop and start all GNUnet default services.

−s | −-start

Start all GNUnet default services on this system (and also ARM). Naturally, if a service is demanded by a default service, it will then also be started. Running "gnunet-arm -s" is the usual way to start a GNUnet peer.

−T −DELAY | −-timeout=DELAY

Exit with error status if operation does not finish after DELAY, provided in number of microseconds.

−v | −-version

Print GNUnet version number.


Start the gnunet-arm for the user:

gnunet-arm -s

Stop the gnunet-arm for the user:

$ gnunet-arm -e


gnunet-config(1), gnunet-setup(1)

The full documentation for gnunet is maintained as a Texinfo manual. If the info(1) and gnunet programs are properly installed at your site, the command

info gnunet

should give you access to the complete handbook,

info gnunet-c-tutorial

will give you access to a tutorial for developers.

Depending on your installation, this information is also available in gnunet(7) and gnunet-c-tutorial(7).


Report bugs by using or by sending electronic mail to ⟨[email protected]⟩. GNU January 4, 2012 GNUNET-ARM(1)

Updated 2024-01-29 - |