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
The node interacts with the Homebridge API, specifically supporting various resources including Backup & Restore. The "Trigger Restore" operation under the Backup & Restore resource allows users to initiate a restoration process of Homebridge data from a backup. This is useful for scenarios such as recovering from data loss, migrating configurations between servers, or rolling back to a previous stable state.
Practical examples:
- Automatically restoring Homebridge configuration after a server crash.
- Migrating Homebridge setup to a new machine by triggering restore from a saved backup.
- Rolling back recent changes by restoring a previous backup snapshot.
Properties
| Name | Meaning |
|---|---|
| Access Token | An access token obtained from a prior login operation or entered manually if not connected. |
Output
The node outputs JSON data representing the result of the restore trigger operation. This typically includes status information about the restore process, such as success confirmation or error details. There is no indication that binary data is output by this node.
Dependencies
- Requires an API key credential (access token) for authentication with the Homebridge API.
- The node depends on connectivity to a configured Homebridge server URL.
- Proper credentials and permissions are necessary to perform backup and restore operations.
Troubleshooting
Common issues:
- Invalid or missing access token will cause authentication failures.
- Network connectivity problems to the Homebridge server can prevent triggering restore.
- Insufficient permissions on the API token may block restore operations.
Error messages:
- Authentication errors typically indicate invalid or expired tokens; re-authenticate or provide a valid token.
- Connection timeouts suggest network or server availability issues; verify server URL and network status.
- API errors related to restore might indicate corrupted backup data or unsupported restore states; check backup integrity.
Links and References
- Homebridge API Documentation (general reference for API endpoints)
- Homebridge GitHub Repository (for source and community support)