Integración domótica Shutdown PC, gratuita y de código abierto
Shut down your Windows and Linux computers over SSH from a dashboard or a scene.
Publicado por LuckyS7evin
- Dispositivos
- Versión 2.0.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Shut down your Windows and Linux computers from Gladys: a button on the dashboard, a dedicated widget or a scene action ("shut the office PC down at 11 pm", "turn everything off when I leave"…).
The integration connects to the computer over SSH and runs the shutdown command. Nothing to install: the SSH server is built into Windows 10 and 11, and available on every Linux distribution.
1. Prepare the computer
Give the computer a fixed IP address (a DHCP reservation in your router): the integration reaches it at that address.
Windows 10 / 11
Open PowerShell as administrator and run:
## Install and start the SSH server, at every Windows startup too
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Start-Service sshd
Set-Service -Name sshd -StartupType 'Automatic'
## Check that the firewall lets port 22 in (rule created by the install)
Get-NetFirewallRule -Name *OpenSSH-Server* | Select-Object Name, Enabled
Use an administrator account of the computer. With a Microsoft account,
the user is the name of the C:\Users\<name> folder and the password is the
Microsoft account password (not the PIN).
Linux
sudo apt install openssh-server # or your distribution's equivalent
Unless you use root, allow the chosen user (here john) to power the
machine off without a password, and nothing else:
echo "john ALL=(root) NOPASSWD: $(command -v systemctl) poweroff" | sudo tee /etc/sudoers.d/gladys-shutdown
sudo chmod 440 /etc/sudoers.d/gladys-shutdown
2. Choose the authentication
Public key (recommended). The integration generates its own SSH key.
Click Show the public key in the Configuration tab and copy the
ssh-ed25519 … gladys-shutdown-pc line to the computer. No password of the
computer is stored in Gladys then.
-
Windows, administrator account: the key goes into a file shared by every administrator, which must be protected (PowerShell as administrator):
Add-Content -Force -Path "$env:ProgramData\ssh\administrators_authorized_keys" -Value 'ssh-ed25519 AAAA… gladys-shutdown-pc'icacls.exe "$env:ProgramData\ssh\administrators_authorized_keys" /inheritance:r /grant "*S-1-5-32-544:F" /grant "*S-1-5-18:F" -
Linux: add the line to the user's
~/.ssh/authorized_keys.
Password. Just enter the account password when adding the computer. It is stored in the integration's data volume, readable by the integration only, and never sent back to the interface. With a password set, the key is still tried first.
3. Add the computers
In the integration's Configuration tab:
- Add a computer: name, IP address or host name, SSH port (22), user, system, optional password. The integration saves the computer, then tests the connection right away (without shutting it down) and shows the result.
- Open the Discovery tab and create the device in a room.
- Repeat for every computer.
Options:
- Force applications to close (Windows, on by default): otherwise an unsaved document can block the shutdown.
- Custom command: replaces the default command, e.g.
shutdown /hto hibernate on Windows, orsudo -n systemctl suspendon Linux (with the matching sudoers rule).
The other buttons:
- Test the connection: connects to the chosen computer and checks the rights, without shutting it down. On Linux it also checks the sudoers rule.
- Edit a computer: enter all the values again. Leave the password empty to keep the current one, or tick Remove the stored password to switch to the key only. Rename the device in Gladys itself.
- Remove a computer: delete its device in Gladys, the integration forgets it at once.
The SSH connection timeout setting is how long to wait for a computer (10 s by default).
4. Shut down
- Dashboard: every computer is a device with a Shut down button, shown in its room's widget.
- "Shutdown PC" widget: add it to a dashboard and choose the computer in its settings. It shows whether the computer is reachable and offers a Shut down button that asks for confirmation.
- Scenes (Integrations category): the Shut down a computer action
returns
success(true/false), which the following actions can test. The standard "Control devices" action on the computer's button works too.
Security
- On the first successful connection, the integration remembers the fingerprint of the computer's host key. It then refuses to connect to a machine presenting another key (IP address spoofing). After reinstalling the computer, use Edit a computer to trust it again.
- Neither the passwords nor the private key ever appear in the logs.
Troubleshooting
| Message | What to do |
|---|---|
| no answer | The computer is off or asleep, or sshd is not running (Get-Service sshd). |
| unreachable | Check the IP address, the port and the computer's firewall. |
| authentication refused | Check the user and the password, or the public key and the rights of administrators_authorized_keys (the icacls command). |
| sudo asks for a password | Add the sudoers rule of step 1. |
| the SSH host key changed | Was the computer reinstalled? Use Edit a computer. Otherwise, be careful. |
| the command failed (exit code 5) | "Access is denied" on Windows: use an administrator account. |
The integration logs (Gladys interface or docker logs) detail every
attempt.
Parámetros de configuración
Estos son los parámetros que Shutdown PC te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | Enable the SSH server on each computer (built into Windows 10 and 11), then add the computers with the buttons below and create them from the Discovery tab. Each computer becomes a device with a "Shut down" button. |
| SSH connection timeout (s) | number | No | How long to wait for a computer before giving up. |
Cómo instalar Shutdown PC en Gladys
- En Gladys, abre Integraciones: Shutdown PC aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/luckys7evin/gladys-shutdown-pc:2.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LuckyS7evin/gladys-shutdown-pc.
Shutdown PC requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Shutdown PC es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LuckyS7evin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación