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 perform various operations related to Homebridge, a platform for integrating smart home devices. Specifically, the "Restart Docker Container" operation under the "Platform Tool" resource enables restarting the Docker container running Homebridge. This is useful for applying configuration changes, recovering from errors, or refreshing the environment without manually accessing the Docker host.
Practical examples include:
- Automatically restarting the Homebridge Docker container after updating plugins or configurations.
- Scheduling periodic restarts to maintain system stability.
- Triggering a restart as part of an automated recovery workflow when certain error conditions are detected.
Properties
| Name | Meaning |
|---|---|
| Access Token | Access token obtained from a prior login operation or entered manually for authentication. |
Output
The node outputs JSON data representing the result of the restart operation. This typically includes status information confirming whether the Docker container was successfully restarted or if any errors occurred during the process.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Homebridge API endpoint, typically hosted within a Docker container.
- Needs an access token for authentication, which can be obtained via a login operation or provided manually.
- The node expects the Homebridge server URL and credentials to be configured properly in n8n.
Troubleshooting
Common Issues:
- Invalid or expired access token leading to authentication failures.
- Network connectivity problems preventing communication with the Homebridge API.
- Insufficient permissions on the Docker host to restart containers.
Error Messages:
- Authentication errors indicating invalid tokens: Ensure the access token is current and correctly supplied.
- Connection timeouts or unreachable host errors: Verify the Homebridge server URL and network accessibility.
- Permission denied errors: Confirm that the user associated with the API token has rights to manage Docker containers.
Resolving these issues generally involves verifying credentials, network settings, and user permissions.
Links and References
- Homebridge Official Website
- Docker Documentation
- Homebridge API Documentation (if available) (Note: actual API docs may vary)