Skip to content

Add admin restart button for Stationarr #58

Description

@rroy676

Goal

Add an admin-only restart button so users can restart Stationarr from the UI after updates, configuration changes, or troubleshooting.

Problem

Self-hosted users sometimes need to restart the Stationarr app container after configuration changes, testing, or troubleshooting. Today this requires opening Docker, Portainer, Unraid, SSH, or the VPS terminal.

An in-app restart button would make support and administration easier.

Expected behaviour

Add a restart action under a System area, such as:

System → Tasks → Restart Stationarr

or:

System → Health → Restart Stationarr

The action should require confirmation before running.

Suggested implementation

For Docker installs, the first version can restart Stationarr by gracefully terminating the Node process and relying on the container restart policy, for example:

restart: unless-stopped

The backend can return a response to the frontend, then perform a delayed graceful shutdown and call:

process.exit(0)

Docker should then restart the container automatically.

Safety requirements

  • Admin-only.
  • Require confirmation.
  • Show a warning that Stationarr may be unavailable briefly.
  • Do not require Docker socket access for the first version.
  • Do not restart the EPG sidecar unless explicitly added later.
  • Do not expose this action to unauthenticated users.
  • Do not allow non-admin/API users to restart the app without explicit permission support.
  • Log the restart request in the app logs once Add in-app Logs page #48 exists.

Suggested UI

Restart Stationarr

This will briefly stop the Stationarr app process. If you are running Docker with restart: unless-stopped, the container should restart automatically.

[Cancel] [Restart]

After clicking restart, the frontend could show:

Stationarr is restarting. Please wait a few seconds, then refresh the page.

Optional future enhancements

- restart EPG sidecar if Docker socket is available
- restart both Stationarr and EPG sidecar
- show last restart time
- show uptime
- add restart task to System → Tasks
- add health warning if restart policy may not bring the container back

Validation

  • Click Restart Stationarr as an admin.
  • Confirm a confirmation prompt appears.
  • Confirm the frontend shows a restarting message.
  • Confirm the Node process exits cleanly.
  • Confirm Docker restarts the container when restart policy is enabled.
  • Confirm the app comes back online.
  • Confirm non-admin users cannot restart the app.

Related

Related to System Tasks (#46), System Health (#45), and in-app Logs (#48).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions