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, specifically supporting operations related to "Backup & Restore" of Homebridge data. The "Download Backup" operation allows users to retrieve a backup file from their Homebridge server. This is useful for scenarios where you want to programmatically download and store backups of your Homebridge configuration and data, enabling automated backup workflows or integration with external storage systems.
Practical examples include:
- Automatically downloading daily backups of Homebridge configurations to cloud storage.
- Integrating backup retrieval into broader home automation maintenance scripts.
- Archiving Homebridge state before performing updates or changes.
Properties
| Name | Meaning |
|---|---|
| Access Token | An access token obtained from a prior login operation or entered manually. Used for authenticating requests to the Homebridge API when downloading the backup. |
Output
The node outputs JSON data representing the downloaded backup content from the Homebridge server. The exact structure depends on the Homebridge API response but typically includes the backup file data or metadata about the backup.
If the backup contains binary data (e.g., a compressed archive), the node may output this as binary data attached to the item, allowing further processing or saving to disk.
Dependencies
- Requires an active connection to a Homebridge server with API access enabled.
- Needs an access token credential for authentication, which can be obtained via a login operation or provided manually.
- The node expects the Homebridge server URL to be configured in credentials or environment variables.
Troubleshooting
- Authentication errors: If the access token is missing, invalid, or expired, the node will fail to authenticate. Ensure the token is correct and refreshed if necessary.
- Connection issues: Verify that the Homebridge server URL is reachable and the API is accessible.
- Invalid resource or operation selection: Confirm that the "Backup & Restore" resource and "Download Backup" operation are selected correctly.
- Unexpected response format: If the backup data is not returned as expected, check the Homebridge server version compatibility and API documentation.
Links and References
- Homebridge API Documentation
- Homebridge GitHub Repository
- n8n Documentation on Creating Custom Nodes