Mac
This guide shows you how to install CUBE OS on macOS with the One-click Installer. The installer prepares the environment, creates the virtual machine, and starts CUBE OS for you.
This guide follows the current one-click installer flow. Some labels may vary by version.
1. Preparation
Check your Mac
Make sure your Mac is ready for installation:
OS: A supported macOS version
Network: Stable internet and LAN access
Permissions: Administrator access on macOS
Zigbee Adapter (Optional)
If you need to add Zigbee devices, prepare a Zigbee Dongle. Tested Zigbee Dongles include:
SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Others listed by developer @darkxst
For more information on Zigbee configurations and compatibility, please refer to this guide.
2. Install CUBE OS with the One-click Installer
Open the installer
Find the installer in Downloads or your chosen folder. Open the package and follow the on-screen steps.
Let the installer check VirtualBox
The installer checks whether VirtualBox is available on your Mac. If VirtualBox is not installed, follow the on-screen steps to install it first.
Set virtual machine resources
Choose the virtual machine name, memory, and CPU cores. Recommended settings:
Memory: 2048 MB or more
CPU: 2 cores or more
Select a bridged network adapter
Choose an active network adapter on your Mac. Use a bridged adapter so CUBE OS can join your local network.
Optional: Configure USB passthrough
If you use a Zigbee dongle, select the USB device from the list. If you do not need Zigbee now, skip this step.
Start the installation
The installer creates the CUBE OS virtual machine and starts the setup automatically. Wait until the installation completes.
3. Boot and access CUBE OS
Wait for CUBE OS to start
After installation, CUBE OS starts automatically. When boot completes, note the CUBE OS IP address shown on screen.
Open the CUBE OS web console
Open a browser on the same network and visit one of these addresses:
http://<CUBE_OS_IP>/
Use the short local address later
After setup, you can find the short ID on the settings page.
You can then use cube-{short-id}.local to identify this CUBE OS instance on your LAN.
Last updated