acme status

Returns the status of certificates configured with an acme configuration section.

Description Jump to heading #

The acme status command returns the following information, separated by tabs:

• The certificate’s name.
• The name of the acme section in the configuration.
• The state of the ACME task, either Running, Scheduled, or Stopped.
• The certificate’s UTC expiration date in ISO 8601 format.
• The relative expiration time (0d if expired).
• The certificate’s UTC scheduled date in ISO 8601 format.
• The relative schedule time (0d if Running).

Examples Jump to heading #

• View the status of a certificate request after calling acme renew.

  nix
  echo "acme status" | sudo socat stdio tcp4-connect:127.0.0.1:9999

  nix
  echo "acme status" | sudo socat stdio tcp4-connect:127.0.0.1:9999

  output
  text
  certificate        section              state    expiration date (UTC)  expires in      scheduled date (UTC)  scheduled in
  @my_files/example  letsencrypt-staging  Running  2026-09-30T20:37:44Z   364d 23h50m02s  -                     -              -

  output
  text
  certificate        section              state    expiration date (UTC)  expires in      scheduled date (UTC)  scheduled in
  @my_files/example  letsencrypt-staging  Running  2026-09-30T20:37:44Z   364d 23h50m02s  -                     -              -

See also Jump to heading #

• acme renew