OS Manuals

/usr/bin/cull_idle_servers.py

Executable binaries for jupyterhub-idle-culler installed for python3.11

From py3.11-jupyterhub-idle-culler-bin 2.0.0-r0 (os), captured 2026-11-05 by running cull_idle_servers.py --help (exit 0). permalink

This is an application.

Options
=======
The options below are convenience aliases to configurable class-options,
as listed in the "Equivalent to" description-line of the aliases.
To see all configurable class-options for some <cmd>, use:
    <cmd> --help-all

--generate-config
    Generate default config file.
    Equivalent to: [--IdleCuller.generate_config=True]
--api-page-size=<Int>
    Number of users to request per page, when using JupyterHub 2.0's paginated
    user list API. Default: user the server-side default configured page size.
    Default: 0
    Equivalent to: [--IdleCuller.api_page_size]
--concurrency=<Int>
    Limit the number of concurrent requests made to the Hub.

    Deleting a lot of users at the same time can slow down the Hub, so limit the
    number of API requests we have outstanding at any given time.
    Default: 10
    Equivalent to: [--IdleCuller.concurrency]
--config=<Unicode>
    Config file to load.
    Default: 'idle_culler_config.py'
    Equivalent to: [--IdleCuller.config_file]
--cull-admin-users=<Bool>
    Whether admin users should be culled (only if --cull-users=true).
    Default: True
    Equivalent to: [--IdleCuller.cull_admin_users]
--cull-default-servers=<Bool>
    Whether default servers should be culled (only if --cull-default-
    servers=true).
    Default: True
    Equivalent to: [--IdleCuller.cull_default_servers]
--cull-every=<Int>
    The interval (in seconds) for checking for idle servers to cull.
    Default: 0
    Equivalent to: [--IdleCuller.cull_every]
--cull-named-servers=<Bool>
    Whether named servers should be culled (only if --cull-named-servers=true).
    Default: True
    Equivalent to: [--IdleCuller.cull_named_servers]
--cull-users=<Bool>
    Cull users in addition to servers.

    This is for use in temporary-user cases such as tmpnb.
    Default: False
    Equivalent to: [--IdleCuller.cull_users]
--internal-certs-location=<Unicode>
    The location of generated internal-ssl certificates (only needed with --ssl-
    enabled=true).
    Default: 'internal-ssl'
    Equivalent to: [--IdleCuller.internal_certs_location]
--max-age=<Int>
    The maximum age (in seconds) of servers that should be culled even if they
    are active.",
    Default: 0
    Equivalent to: [--IdleCuller.max_age]
--remove-named-servers=<Bool>
    Remove named servers in addition to stopping them.

    This is useful for a BinderHub that uses authentication and named servers.
    Default: False
    Equivalent to: [--IdleCuller.remove_named_servers]
--ssl-enabled=<Bool>
    Whether the Jupyter API endpoint has TLS enabled.
    Default: False
    Equivalent to: [--IdleCuller.ssl_enabled]
--timeout=<Int>
    The idle timeout (in seconds).
    Default: 600
    Equivalent to: [--IdleCuller.timeout]
--url=<Unicode>
    The JupyterHub API URL.
    Default: None
    Equivalent to: [--IdleCuller.url]

To see all available configurables, use `--help-all`.
Options (15)
OptionDescriptionSource
--generate-configGenerate default config file.help
--api-page-size IntNumber of users to request per page, when using JupyterHub 2.0's paginated user list API.help
--concurrency IntLimit the number of concurrent requests made to the Hub.help
--config UnicodeConfig file to load.help
--cull-admin-users BoolWhether admin users should be culled (only if --cull-users=true).help
--cull-default-servers BoolWhether default servers should be culled (only if --cull-default- servers=true).help
--cull-every IntThe interval (in seconds) for checking for idle servers to cull.help
--cull-named-servers BoolWhether named servers should be culled (only if --cull-named-servers=true).help
--cull-users BoolCull users in addition to servers.help
--internal-certs-location UnicodeThe location of generated internal-ssl certificates (only needed with --ssl- enabled=true).help
--max-age IntThe maximum age (in seconds) of servers that should be culled even if they are active.", Default: 0 Equivalent to: [--IdleCuller.max_age]help
--remove-named-servers BoolRemove named servers in addition to stopping them.help
--ssl-enabled BoolWhether the Jupyter API endpoint has TLS enabled.help
--timeout IntThe idle timeout (in seconds).help
--url UnicodeThe JupyterHub API URL.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.