Starting the Server

oidentd can be run as a standalone program or started by a service manager. It will fork to the background by default.

If you installed oidentd from your distribution’s package repositories, an init script or service file may already have been included for you. Consult your distribution’s documentation for more information.

oidentd needs to be started as root on most systems, but will normally drop privileges automatically after starting up. See Dropping Privileges for details.

You can start oidentd with the following command:

oidentd [OPTIONS]

You may find some of the following options useful:

  • -a, --address: bind to the specified address (can be specified more than once)
  • -C, --config: load the specified configuration file instead of the default
  • -d, --debug: show messages that may be useful for debugging
  • -i, --foreground: do not fork to background
  • -p, --port: listen on the specified port instead of port 113

systemd Service

Many systemd-based distributions include service unit configurations for oidentd. On these distributions, oidentd can be started and enabled with the following command:

systemctl enable --now oidentd

Further Reading

The oidentd(8) manual page contains a list of all available options with detailed explanations. Alternatively, oidentd --help prints a list with shorter descriptions.