CRYPTSETUP-ISLUKS(8)

πŸ’… CRYPTSETUP-ISLUKS πŸ’…

okay bestie, welcome to cryptsetup-isLuks β€” she's a lil command from the cryptsetup manual (section 8, Maintenance Commands, iykyk) and honestly? she's giving "am I LUKS or not" and nothing else. queen of the yes/no question. πŸŽ€


✨ NAME ✨

cryptsetup-isLuks β€” check if a device is a LUKS device πŸ¦‹


🌸 SYNOPSIS 🌸

cryptsetup isLuks [<options>] <device>

πŸ’– DESCRIPTION πŸ’–

So basically: this returns true if <device> is a LUKS device, and false otherwise. That's it. That's the whole job. iconic behaviour honestly. πŸ’…

Slap on the -v option and you get actual human-readable feedback instead of cryptic silence. If it prints 'Command successful.' β€” congrats babe, that device is a LUKS device. πŸŽ‰

And if you wanna get specific? By specifying --type you can query for a particular LUKS version. main character energy: know exactly which version you're asking about. πŸ‘‘

Oh and for the record, <options> can be [--header, --type, --disable-locks]. that's the whole guest list. 🫢


🌈 OPTIONS 🌈

  • --batch-mode, -q β€” suppresses all the confirmation questions. no "are you sure" energy, just vibes. Use with care! 😭 Also β€” heads up β€” if the --verify-passphrase option is not specified, this option also switches off the passphrase verification. so yeah, careful bestie.
  • --debug or --debug-json β€” run in debug mode with full diagnostic logs. every debug output line is always prefixed by #. And if you go with --debug-json, you also get additional LUKS2 JSON data structures printed out. extra data? we love to see it. ✨
  • --disable-locks β€” turns off lock protection for metadata on disk. This option is valid only for LUKS2 and gets ignored for every other format. ngl, it only works for one of the girlies. πŸ’€
⚠️ WARNING: do not use this option unless you're running cryptsetup in a restricted environment where locking is literally impossible to perform (like, where the /run directory cannot be used). fr fr, this one is a last resort. 🚨
  • --header <device or file storing the LUKS header> β€” use a detached (separated) metadata device or file where the LUKS header lives. this option lets you keep the ciphertext and the LUKS header on different devices β€” long-distance relationship, but make it storage. πŸ¦‹

For commands that change the LUKS header (e.g., luksAddKey), specify the device or file with the LUKS header directly as the LUKS device. yes, directly. no middleman. πŸ’…

  • --help, -? β€” show help text and default parameters. always read the manual, bestie. πŸ“–
  • --type type β€” specifies the required device type. for more info, read the BASIC ACTIONS section in cryptsetup(8). go read it, I'll wait. 🫢
  • --usage β€” show short option help. the lil snack-sized version. πŸ“
  • --verbose, -v β€” print more information on command execution. this is the one that gives you the human-readable feedback, remember? ✨
  • --version, -V β€” show the program version. gotta know which era of cryptsetup you're living in. 🌸

😭 REPORTING BUGS 😭

Found a bug? Report it at the cryptsetup mailing list <cryptsetup@lists.linux.dev> or in the Issues project section at <https://gitlab.com/cryptsetup/cryptsetup/-/issues/new>. πŸ›

And please β€” pretty please β€” attach the output of the failed command with the --debug option added. we need the receipts, bestie. πŸ’œ


πŸ‘‘ SEE ALSO πŸ‘‘


πŸŽ€ CRYPTSETUP πŸŽ€

Part of the cryptsetup project β€” <https://gitlab.com/cryptsetup/cryptsetup/>. the whole squad. πŸ’–


and that's the page, babe! this was cryptsetup 2.8.8, dated 2026-09-07 β€” literally the freshest. now go check if your device is LUKS, periodt. πŸ’…βœ¨πŸ¦‹

πŸ“¦ where this page comes from