DOVEADM-SERVICE-STATUS(1)

πŸ“¦
version 2.4.5 Β· 4 versions
, in alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ DOVEADM-SERVICE-STATUS πŸ’…

okay bestie, welcome to the Doveadm manual, section 1 πŸŽ€ this is your little backstage pass to peeking at what all the Dovecot services are actually doing right now. no cap, it's giving surveillance but make it cute πŸ¦‹


🌸 NAME 🌸

doveadm-service-status β€” show information about dovecot services πŸ‘€βœ¨


🌈 SYNOPSIS 🌈

doveadm [GLOBAL OPTIONS] service status [service [...]]

πŸ’– DESCRIPTION πŸ’–

so doveadm service status spits out a whole table, one line per service, and every line is packed with these little details. let's go through them one by one, bestie, because iykyk that the details are the whole point πŸ”₯

  • name β€” the name of the service 🏷️
  • process_count β€” the number of processes actually running for the service (like, fr fr running, not just vibing)
  • process_avail β€” the number of additional processes that can be spawned for the service
  • process_limit β€” the maximum number of processes that can be active for the service
  • client_limit β€” the maximum number of connections that the service will handle simultaneously
  • throttle_secs β€” seconds to wait before launching another process when processes are dying unexpectedly early for the service πŸ’€
  • exit_failure_last β€” timestamp when the last process was terminated abnormally for the service
  • exit_failures_in_sec β€” number of abnormally terminated processes for the service in the last second 😭
  • last_drop_warning β€” timestamp when the last time a "dropping client connections" warning was logged
  • listen_pending β€” if the master process is queuing connections that need to be dispatched
  • listening β€” if service is listening πŸ‘‚
  • doveadm_stop β€” if the service has been stopped by doveadm(1)
  • process_total β€” the total number of processes forked for the service since the service start.

πŸ‘‘ GLOBAL OPTIONS πŸ‘‘

these are the global doveadm(1) options, babes. they apply across the board:

  • -D β€” Enables verbosity and debug messages. πŸ›
  • -O β€” Do not read any config file, just use defaults. The dovecot_storage_version setting defaults to the latest version, but can be overridden with -o.
  • -k β€” Preserve entire environment for doveadm, not just import_environment setting.
  • -v β€” Enables verbosity, including progress counter. πŸ“ˆ
  • -i instance-name β€” If using multiple Dovecot instances, choose the config file based on this instance name. See instance_name setting for more information.
  • -c config-file β€” Read configuration from the given config-file. By default it first reads config socket, and then falls back to /etc/dovecot/dovecot.conf. You can also point this to config socket of some instance running compatible version.
  • -o setting=value β€” Overrides the configuration setting from /etc/dovecot/dovecot.conf and from the userdb with the given value. In order to override multiple settings, the -o option may be specified multiple times. πŸ”
  • -f formatter β€” Specifies the formatter for formatting the output. Supported formatters are:
    • flow β€” prints each line with key=value pairs.
    • json β€” prints a JSON array of JSON objects.
    • pager β€” prints each key: value pair on its own line and separates records with form feed character (^L).
    • tab β€” prints a table header followed by tab separated value lines.
    • table β€” prints a table header followed by adjusted value lines.

πŸŽ€ ARGUMENTS πŸŽ€

  • service (optional) β€” Filters the list according to the specified service or services. By default, all dovecot services are listed. 🌟

πŸ¦‹ EXAMPLES πŸ¦‹

okay so here's what it looks like when you just run it, no filter, living its best life:

doveadm service status

name: imap-login
process_count: 0
process_avail: 0
process_limit: 1
client_limit: 1000
throttle_secs: 0
exit_failure_last: 0
exit_failures_in_sec: 0
last_drop_warning: 0
listen_pending: n
listening: y
doveadm_stop: n
process_total: 0

😭 REPORTING BUGS 😭

found a bug? not the vibe, but okay, we handle it 🫢 Report bugs, including doveconf -n output, to the Dovecot Mailing List ⟨dovecot@dovecot.org⟩. Information about reporting bugs is available at: ⟨https://dovecot.org/bugreport.html⟩

bestie pls include that doveconf -n output, they literally need it πŸ™

πŸ’œ SEE ALSO πŸ’œ

doveadm(1), doveadm-process-status(1)


and that's the whole page, periodt πŸ’…βœ¨ this was Doveadm manual, section 1, source version f979264, dated April 2026 β€” go forth and check on your services, queen πŸ‘‘πŸŒˆ

πŸ“¦ where this page comes from