unraid / unraid/api

Add mutation that allows server shutdown

Open
#2,023 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
113
Forks
22
Avg merge
10h 40m
Merged PRs (30d)
13

Description

Is your feature request related to a problem?

To save electricity, I don't keep my Unraid server running 24/7. Instead, I can turn it on via Wake-on-LAN, and shut it down via the Unraid UI. I'd like to automate these tasks as part of a smart system, and that works fine for the WOL call, but I currently can't shutdown the server from an automation.

Describe the solution you'd like

A new Unraid API mutation to shutdown the server.

Describe alternatives you've considered

Installing an additional API on my server that supports this. I'm not aware of any existing solutions that allow this, and I would prefer first-party support.

Additional context

Environment (if relevant)

Unraid OS Version: 7.3.1

Pre-submission Checklist

  • I have searched existing issues to ensure this feature hasn't already been requested
  • This is not an Unraid Connect related feature (if it is, please submit via the support form instead)
  • I have provided clear examples or use cases for the feature

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue does not name files or tests. Start by locating the existing Unraid API mutation entry points and the server shutdown behavior used by the Unraid UI; the work is done when a first-party mutation can safely request server shutdown for the described automation use case and its behavior is covered by appropriate tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.