REBOOTMGRCTL(1)

💅 REBOOTMGRCTL(1) — the group-chat guide to controlling the reboot manager 💅

🌸 NAME 🌸

rebootmgrctl is the tool to control and configure the rebootmgrd(8) daemon — like the group-chat admin for your reboot manager, fr fr.

🦋 SYNOPSIS 🦋

okay bestie, here’s the whole synopsis in one code block, no cap:

rebootmgrctl [--help | --version]

rebootmgrctl is-active [--quiet]

rebootmgrctl reboot [now]

rebootmgrctl soft-reboot [now]

rebootmgrctl cancel

rebootmgrctl status [--full] [--quiet]

rebootmgrctl set-strategy best-effort | maint-window | instantly | off |
             on

rebootmgrctl get-strategy

rebootmgrctl set-window time duration

rebootmgrctl get-window

💜 DESCRIPTION 💜

okay so rebootmgrctl is used to query and configure the rebootmgrd(8) process — that’s the whole plot, but it’s iconic 💖

👑 OPTIONS 👑

here’s every flag and subcommand, in order, with zero skips — we don’t gatekeep 💅

• --help — display help text and exit
• --version — output version information and exit
• cancel — Cancels an already running reboot.
• is-active [--quiet] — Prints whether rebootmgrd is running and active or not. With the --quiet option, rebootmgrctl does not print any output, but returns 0 if rebootmgrd is running or 1 if not.
• reboot [now] — Tells rebootmgrd to schedule a reboot. With the now option, a forced reboot is done and a maintenance window is ignored. If there is already a reboot or soft-reboot scheduled, this request is ignored.
• soft-reboot [now] — Tells rebootmgrd to schedule a soft-reboot (see systemd-soft-reboot.service(8)). With the now option, a forced soft-reboot is done and a maintenance window is ignored. If there is already a reboot or soft-reboot scheduled, this request is ignored.
• status [--full|--quiet] — Prints the current status of rebootmgrd. With the --full option, not only the current status, but also the configuration values currently in use are printed. With the --quiet option, rebootmgrctl does not print any output, but returns the current reboot status as return value. Valid values are:
  • 0 — No reboot requested
  • 1 — Reboot requested
  • 2 — Reboot requested, waiting for maintenance window
• set-strategy best-effort|maint-window|instantly|off|on — A new strategy to reboot the machine is written in /etc/rebootmgr/rebootmgr.conf.d/50-strategy.conf.
  • best-effort — This is the default setting. If a maintenance window is specified, maint-window is used. If no maintenance window is specified, the reboot takes place immediately (instantly).
  • maint-window — Reboot only during a specific maintenance window. If no maintenance window is specified, the system reboots immediately.
  • instantly — The reboot is carried out without waiting for a maintenance window.
  • off — rebootmgrd continues to run, but ignores all reboot timers that expire in the meantime. The configuration file is not updated, so this option is no longer active after a reboot. When rebootmgr is reactivated, it will continue to use the old specified maintenance window and any reboot timers that are still running will no longer be ignored.
  • on — Reboots will be enabled again.
• get-strategy — The currently used reboot strategy of rebootmgrd will be printed.
• set-window time duration — Sets the maintenance window. The format of time is a calendar event described in systemd.time(7). The format of duration is [XXh][YYm].

A new maintenance window is written in /etc/rebootmgr/rebootmgr.conf.d/50-maintenance-window.conf.

• get-window — The currently set maintenance window will be printed.

🔗 SEE ALSO 🔗

• systemd.time(7)
• systemd-soft-reboot.service(8)

✍️ AUTHOR ✍️

Thorsten Kukuk <kukuk@suse.de> — the icon who wrote this 🫶

okay bestie, that’s the whole manual 💖 source/version: rebootmgr; date: 05/12/2025 — now go forth and manage those reboots like the main character you are 🌈👑✨