SeloraBox Installation Guide

SeloraBox is Selora Homes’ managed instance of Home Assistant, providing enterprise-grade reliability with automated provisioning and management. This guide walks you through the complete installation process from hardware preparation to initial setup.

Prerequisites

Hardware Requirements

Recommended Device: Bee-Link EQ14

• Processor: Intel® Twin Lake N150
• RAM: 16GB
• Storage: 500GB hard drive
• Network: 1 Gigabit Ethernet port (minimum)
• Boot Media: USB flash drive (8GB or larger)

Network Requirements

• Ethernet connection with DHCP enabled
• Internet access for initial configuration and updates
• Stable network during installation (approximately 15-30 minutes)

Installation Tools

• USB flash drive (8GB or larger, will be erased during flashing)
• Balena Etcher or equivalent ISO flashing tool
• Computer for downloading ISO and flashing USB drive

Installation Overview

SeloraBox uses an automated installation process that sets up:

1. Proxmox Hypervisor: Enterprise-grade virtualization platform
2. Home Assistant VM: Pre-configured virtual machine
3. Ansible Configuration: Automatic system provisioning

The entire process is hands-off after booting from the USB drive.

Step 1: Download the ISO Image

1. Navigate to https://downloads.selorahomes.com/
2. Download the latest SeloraBox ISO image (e.g., selorabox-9.0-1.iso)
3. Verify the file size and checksum if provided

Step 2: Flash the USB Drive

Using Balena Etcher (Recommended)

1. Download and install Balena Etcher
2. Insert your USB flash drive
3. Launch Balena Etcher
4. Flash from file: Select the downloaded SeloraBox ISO
5. Select target: Choose your USB drive
6. Click Flash and wait for completion

Verification

• Etcher will automatically verify the flash process
• Safely eject the USB drive when complete
• The USB drive is now ready for installation

Step 3: Prepare the Target Device

BIOS Configuration

1. Power off the target device completely
2. Insert the flashed USB drive
3. Power on and enter BIOS/UEFI settings (typically F2, F10, F12, or DEL key)
4. Navigate to Boot Options or Boot Order
5. Set USB as the first boot device
6. Save changes and exit BIOS

Boot Sequence

• The device will now boot from the USB drive
• You should see the SeloraBox installer splash screen
• Do not interrupt the installation process

Step 4: Automatic Installation

Once the device boots from the USB drive, the installation runs automatically. You don’t need to do anything - just wait for it to complete.

The installer will set up the Proxmox hypervisor, install base services, configure Ansible, and prepare the device for registration. When complete, the device will display a registration screen with a QR code (see Step 5 below).

Step 5: Device Registration

After the first boot completes, the SeloraBox enters registration mode and displays a QR code on the screen.

Claiming Your Installation

You have two options to claim the installation:

Option 1: Scan the QR Code

1. Use your mobile device to scan the QR code displayed on screen
2. This will automatically open the claim page with your device code

Option 2: Manual Entry

1. Note the code displayed below the QR code on screen
2. Navigate to https://connect.selorahomes.com/claim
3. Enter the code manually

Customer Assignment

After claiming the device, the Selora Connect portal will prompt you to:

• Create a new customer: Set up a new customer profile for this installation
• Connect to existing customer: Link this device to an existing customer by providing their email address

Registered Mode

Once registration is complete, the device transitions to registered mode, which enables:

• Heartbeat monitoring: Device sends status updates to Selora Homes
• Secure network connection: Connected to our managed infrastructure
• Remote access (coming soon): Request temporary remote access that customers can approve
• Automatic updates: Receive configuration updates and security patches via Ansible

Step 6: Configure Home Assistant

Once the device is in registered mode, you can proceed with Home Assistant configuration.

Accessing Home Assistant

1. Check the device screen for the Home Assistant installation URL
2. From another device on the network, navigate to the displayed URL
3. Complete the Home Assistant onboarding wizard:
   • Create your admin account
   • Set up your location and timezone
   • Configure initial integrations

Initial Setup Recommendations

1. Change admin password: Use a strong, unique password
2. Enable advanced mode: Settings → Profile → Advanced Mode
3. Configure backups: Set up automated backup schedule
4. Add integrations: Connect your smart home devices and platforms
5. Create dashboards: Build custom views for your customer

Troubleshooting

Installation Won’t Start

• Verify BIOS boot order: Ensure USB is first
• Re-flash USB drive: Try a different USB port or drive
• Check USB compatibility: Use USB 2.0/3.0 compatible drives
• Disable Secure Boot: Some systems require this for custom ISOs

No Network Connection

• Check DHCP: Ensure your network router has DHCP enabled
• Try different Ethernet port: If device has multiple ports
• Cable test: Verify Ethernet cable is working
• Static IP: Advanced users can configure static IP in Proxmox post-install

Cannot Access Proxmox Web Interface

• Wait longer: First boot can take 5-10 minutes
• Check IP address: Verify from console or router DHCP table
• Firewall: Ensure port 8006 is not blocked on your network
• Certificate: Accept the self-signed certificate warning in your browser

Home Assistant VM Not Starting

1. Log into Proxmox web interface
2. Select the Home Assistant VM
3. Check console for error messages
4. Verify VM has sufficient resources (CPU, RAM) allocated
5. Try manually starting the VM from Proxmox interface

Next Steps

After completing the installation, registration, and initial Home Assistant setup:

1. Add smart home integrations: Connect Zigbee, Z-Wave, Wi-Fi devices and platforms
2. Create automations: Build workflows for your customer’s needs
3. Configure automated backups: Set up regular backup schedule in Home Assistant
4. Design dashboards: Create custom views tailored to your customer
5. Test the system: Verify all devices and automations work as expected
6. Document the setup: Provide your customer with usage instructions

Support

Current Status

• Installation and registration: Available now
• Remote access: Coming soon - customer-approved temporary access
• Documentation updates: Check back regularly for updates
• Feature requests: Contact us with feedback and suggestions

Getting Help

For installation issues or questions:

1. Check this documentation and troubleshooting section
2. Review Proxmox and Home Assistant official docs
3. Contact Selora Homes support at connect.selorahomes.com/support