OS Manuals

/usr/bin/ceph-osd

Ceph OSD (Object Storage Daemon)

From ceph-fips-19-osd 19.2.7-r4 (enterprise-packages), captured 2026-11-08 by running ceph-osd --help (exit 0). permalink

usage: ceph-osd -i <ID> [flags]
  --osd-data PATH data directory
  --osd-journal PATH
                    journal file or block device
  --mkfs            create a [new] data directory
  --mkkey           generate a new secret key. This is normally used in combination with --mkfs
  --monmap          specify the path to the monitor map. This is normally used in combination with --mkfs
  --osd-uuid        specify the OSD's fsid. This is normally used in combination with --mkfs
  --keyring         specify a path to the osd keyring. This is normally used in combination with --mkfs
  --convert-filestore
                    run any pending upgrade operations
  --flush-journal   flush all data out of journal
  --osdspec-affinity
                    set affinity to an osdspec
  --dump-journal    dump all data of journal
  --mkjournal       initialize a new journal
  --check-wants-journal
                    check whether a journal is desired
  --check-allows-journal
                    check whether a journal is allowed
  --check-needs-journal
                    check whether a journal is required
  --debug_osd <N>   set debug level (e.g. 10)
  --get-device-fsid PATH
                    get OSD fsid for the given block device
  --run-benchmark   run a throughput benchmark test against the OSD and dump the result

  --conf/-c FILE    read configuration from the given configuration file
  --id/-i ID        set ID portion of my name
  --name/-n TYPE.ID set name
  --cluster NAME    set cluster name (default: ceph)
  --setuser USER    set uid to user or uid (and gid to user's gid)
  --setgroup GROUP  set gid to group or gid
  --version         show version and quit

  -d                run in foreground, log to stderr
  -f                run in foreground, log to usual location

  --debug_ms N      set message debug level (e.g. 1)
Options (29)
OptionDescriptionSource
--osd-journal PATHjournal file or block devicehelp + man
--mkfsCreate an empty object repository.help + man
--mkkeygenerate a new secret key.help + man
--monmapspecify the path to the monitor map.help
--osd-uuidspecify the OSD's fsid.help
--keyringspecify a path to the osd keyring.help
--convert-filestorerun any pending upgrade operationshelp
--flush-journalFlush the journal to permanent store.help + man
--osdspec-affinitySet an affinity to a certain OSDSpec.help + man
--dump-journaldump all data of journalhelp
--mkjournalCreate a new journal file to match an existing object repository.help + man
--check-wants-journalCheck whether a journal is desired.help + man
--check-allows-journalCheck whether a journal is allowed.help + man
--check-needs-journalCheck whether a journal is required.help + man
--debug_osd Nset debug level (e.g. 10)help
--get-device-fsid PATHget OSD fsid for the given block devicehelp
--run-benchmarkrun a throughput benchmark test against the OSD and dump the resulthelp
--cluster NAMEset cluster name (default: ceph)help
--setuser USERset uid to user or uid (and gid to user's gid)help + man
--setgroup GROUPset gid to group or gidhelp + man
--versionshow version and quithelp
-dDebug mode: like -f, but also send all log output to stderr.help + man
-f, --foregroundForeground: do not daemonize after startup (run in foreground).help + man
--debug_ms Nset message debug level (e.g. 1)help
--osd-data osddataUse object store at osddata. (in the manual page but not in --help)man
--get-cluster-fsidPrint the cluster fsid (uuid) and exit. (in the manual page but not in --help)man
--get-osd-fsidPrint the OSD's fsid and exit. (in the manual page but not in --help)man
--get-journal-fsidPrint the journal's uuid. (in the manual page but not in --help)man
-c, --conf ceph.confUse ceph.conf configuration file instead of the default /etc/ceph/ceph.conf for runtime configuration options. (in the manual page but not in --help)man

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