A custom Home Assistant integration for controlling Vinorage wine cellars with elevation.
Vinorage manufactures premium wine storage solutions with built-in elevation systems that allow wine cellars to be mounted flush with the floor and raised when needed. This integration allows you to control your Vinorage wine cellar directly from Home Assistant.
This integration has been tested with:
- Vinorage Wine Cellar with Elevation (200 bottles) - Exclusive model with elevation system
Other Vinorage models with similar web-based control interfaces may also work, but have not been tested.
This integration provides control over two main components of your Vinorage wine cellar:
- Entity Type: Light
- Features:
- Brightness control (0-100%)
- On/Off control
- Current brightness state monitoring
- Entity Type: Cover
- Features:
- Raise cellar (Open)
- Lower cellar (Close)
- Stop movement
- Stateless operation (position not tracked)
- IP Address: Local network address of your Vinorage device
- Scan Interval: How often to poll the device for LED status (default: 15 seconds, set to 0 to disable)
- Open HACS in Home Assistant
- Click on "Integrations"
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add this repository URL:
https://github.com/msvinth/ha-vinorage - Select category "Integration"
- Click "Add"
- Click "Install" on the Vinorage card
- Restart Home Assistant
- Download the latest release from the releases page
- Extract the
vinoragefolder from the archive - Copy the
vinoragefolder to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- In Home Assistant, go to Settings → Devices & Services
- Click + Add Integration
- Search for "Vinorage"
- Enter your Vinorage device's local IP address (e.g.,
192.168.1.100) - Optionally adjust the scan interval (default: 15 seconds)
- Click Submit
Your Vinorage wine cellar must be connected to your local network. You can find its IP address by:
- Checking your router's connected devices list
- Using a network scanning app
- Checking your DHCP server logs
Note: It's recommended to assign a static IP address to your Vinorage device in your router settings to prevent the IP from changing.
The integration polls the device at the configured interval to update the LED brightness state. The cellar position is not tracked as the device does not provide position feedback.
- Verify the IP address is correct
- Ensure the device is powered on and connected to your network
- Try accessing
http://[IP_ADDRESS]in a web browser to verify the device responds - Check that Home Assistant can reach the device (same network/VLAN)
- Check the scan interval is not set to 0
- Verify the device is responding (check in a web browser)
- Look at Home Assistant logs for any error messages
This is normal behavior. The Vinorage device does not report position, so the cover entity is stateless.
This repository includes a devcontainer for easy development:
# Clone the repository
git clone https://github.com/msvinth/ha-vinorage
cd ha-vinorage
# Open in VS Code with devcontainer
code .# Start Home Assistant in development mode
scripts/develop# Run linters
scripts/lintContributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
If you encounter any issues or have questions:
- Check the troubleshooting section above
- Search existing issues
- Open a new issue with detailed information
This project is licensed under the MIT License - see the LICENSE file for details.
This is an unofficial integration and is not affiliated with, endorsed by, or supported by Vinorage. Use at your own risk.
- Integration developed by msvinth
- Built using the Home Assistant Integration Blueprint
Enjoy your perfectly stored wine! 🍷