pyfingerd command-line reference#

pyfingerd (or python -m pyfingerd) is the command-line used to run the server.

When run through CLI, pyfingerd exposes a number of configuration options using its own code. Each configuration option is configurable through three cumulative means:

  • A UNIX-style command-line option.

  • An environment variable set directly.

  • An environment variable set through a dotenv file (.env).

When a configuration option is given through multiple means, the resolution order of such the value is the one given above.

Available options are:

-b, --binds (BIND)

List of hosts and ports to bind to.

This option must be defined one way or another, and must contain the list of ports to bind separated with commas (,). Each port must have one of the following formats:

Bind on all addresses that resolve as (IPv4 and IPv6), port 79.

Bind on all addresses that resolve as (IPv4 and IPv6), port 1234. or []

Bind on (IPv4), port 79. or []:1234

Bind on (IPv4), port 1234.

::1:2:3:4 or [::1:2:3:4]

Bind on ::1:2:3:4 (IPv6) port 79.


Bind on ::1:2:3:4 (IPv6) port 1234.

Here are some examples:

# On modern platforms, binds on (IPv4)
# and [::1]:79 (IPv6).

# Binds on and [2001:41d0:302:2200::3b2]:79.
-H, --hostname (FINGER_HOST)

Hostname for the server to identify itself when answering queries.

This option is set to LOCALHOST by default.

-t, --type (FINGER_TYPE)

Type of interface for the finger server to query users and sessions.

The possible values for this option are the following:


There is no data (no users, no sessions).


The data is gathered from the system.


The data is gathered from a scenario (see -s, --scenario (FINGER_ACTIONS) below).

By default, the interface type is NATIVE. If an invalid server type is provided, the server is considered a dummy server.

-s, --scenario (FINGER_ACTIONS)

Path to the scenario, in TOML format.

This option is only used when setting the interface type to SCENARIO; see -t, --type (FINGER_TYPE) for more information.

The destination file must be a TOML file representing a scenario; see Scenario files for more information.