TrueNAS shutdown by UPS via ethernet

[PhilD13]

This is what Kris had to say about shutdown on truenas.

@kris

Its always been recommended to try and use the API calls for specific tasks on TrueNAS, even back on the CORE days. TrueNAS is not some generic BSD/Linux distro. It’s a pretty specifically built appliance, designed to be used through the UI and APIs. While there is access to a shell prompt, it is always recommended to use the API commands for those kinds of operations, since that’s how we test and validate the right things happen here internally. We don’t spend cycles wiring up every shell command (of which their are many) to hook back into the API to do the correct and tested shutdown procedures.

Calling the API will essentially run the exact shutdown procedure you would get had you clicked the “Shutdown” button in the UI. Calling that means as we make changes and improvements to the backend across new versions, your scripts will always be following the recommended and tested procedures for whatever task you are trying to automate.

Below is an example of the call and can be done over ssh, from a script, or probably from cron on a schedule. I think you can also use the TrueNAS API directly over WebSocket if desired. If you wish to go that route then the API documentation is available within your TrueNAS GUI under Credentials > Users > API Keys > API Docs button

Using the Command Line (`midclt`) to shutdown
The simplest method is to SSH into the TrueNAS system and execute the `midclt` command with the `system.shutdown` argument. This can be automated.

* **Command:** `/usr/bin/midclt call system.shutdown [reason]`
* **Example:** `/usr/bin/midclt call system.shutdown "scheduled_nightly_shutdown"`

Recent versions of TrueNAS (e.g., TrueNAS Scale 25.04 and later) require a `reason` argument for the command to work.