Returns a list of the units, whether they are loaded, active, their sub and description.

systemctl is-failed

Returns a list of status only.

What is the syntax to return the details of the failed units?

2 Answers 2


You can use systemctl list-units --state=failed to list all failed units.

The parameters for systemctl are documented in the man page systemctl(1).

  • 42
    --failed is an alias for --state=failed
    – sshow
    Aug 2, 2017 at 14:57
  • 6
    Yes thats right, but until 2017-02-02 --failed wasn't documented and marked as deprecated in the codebase (#5198)
    – cg909
    Aug 2, 2017 at 19:08
  • 13
    I see. And from the PR discussion I learned that we can drop list-units and go with systemctl --failed by itself :)
    – sshow
    Aug 2, 2017 at 20:22
  • 11
    I find it very irritating that systemctl status tells me the one+ things are failed, but wont tell me what. I need to run another command, not under the status subcommand to find out. Shame. Jun 22, 2018 at 3:02
  • @NathanLilienthal request a change from the systemd folks. They are quite opinionated on "the one right way of doing things", though.
    – vonbrand
    Feb 25, 2020 at 15:12

This is more simple:

systemctl --failed

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.