Actions77
- Accessory Actions
- Authentication Actions
- Backup & Restore Actions
- Config Editor Actions
- Platform Tool Actions
- Plugin Actions
- Server Actions
- Restart Server
- Restart Child Bridge
- Stop Child Bridge
- Start Child Bridge
- Get Pairing Info
- Reset Homebridge Accessory
- Reset Cached Accessories
- Get Cached Accessories
- Delete Cached Accessories
- Delete Cached Accessory
- Get Device Pairings
- Get Device Pairing
- Delete Device Pairing
- Get Unused Port
- Get Network Interfaces
- Get Bridge Network Interfaces
- Set Bridge Network Interfaces
- Setup Wizard Actions
- Status Actions
- User Actions
Overview
This node integrates with the Homebridge API, allowing users to interact programmatically with various aspects of a Homebridge server. Specifically, the "Restart Server" operation under the "Server" resource enables restarting the Homebridge server remotely. This is useful for applying configuration changes, recovering from errors, or performing maintenance without manual intervention on the host machine.
Practical examples include:
- Automatically restarting the Homebridge server after updating plugins or configurations.
- Scheduling periodic restarts to ensure stability.
- Triggering a restart in response to detected errors or alerts.
Properties
| Name | Meaning |
|---|---|
| Access Token | Access token obtained from a prior login operation or entered manually; used for authentication when calling the Homebridge API. |
Output
The node outputs JSON data representing the response from the Homebridge API after attempting to restart the server. This typically includes status information indicating whether the restart command was accepted or if any errors occurred.
No binary data output is involved.
Dependencies
- Requires an active connection to a Homebridge server with API access enabled.
- Needs an API authentication token (access token) to authorize requests.
- The user must configure credentials containing the Homebridge server URL and provide the access token either dynamically via a Login node or manually.
Troubleshooting
Common issues:
- Invalid or expired access token leading to authentication failures.
- Network connectivity problems preventing communication with the Homebridge server.
- Insufficient permissions for the provided token to perform server control operations.
Error messages:
- Authentication errors usually indicate missing or incorrect access tokens; verify token validity and reauthenticate if necessary.
- Connection timeouts suggest network issues or incorrect server URLs; check server availability and credential settings.
- API errors may return descriptive messages from Homebridge; review these to adjust request parameters or permissions.