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 5-10 minutes)

For detailed firewall rules and required endpoints, see the Network Requirements page.

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. Base System: Atomic, reliable operating system with rollback capability
2. Home Assistant: Pre-configured Home Assistant installation

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 (if unsure, use the Intel & AMD processors ISO image)
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. Disable Secure Boot: Navigate to Security settings and disable Secure Boot
5. Navigate to Boot Options or Boot Order
6. Set USB as the first boot device
7. 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 base system, install Home Assistant, 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

For Installers Only

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 and displays the management screen.

The management screen shows:

• Device status: Current state of the SeloraBox
• Home Assistant status: Whether Home Assistant is running
• Secure remote access: Configuration status for remote connectivity
• IP address: The device’s network address for local access
• Software versions: Technical information about installed components

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. Add integrations: Connect your smart home devices and platforms
3. Create dashboards: Build custom views for your customer

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. Design dashboards: Create custom views tailored to your customer
4. Test the system: Verify all devices and automations work as expected
5. Document the setup: Provide your customer with usage instructions

Backups are automatically configured - see the Backups documentation for details.

Troubleshooting

Installation Won’t Start

• Disable Secure Boot: Secure Boot must be disabled (see Step 3)
• Verify BIOS boot order: Ensure USB is first
• Re-flash USB drive: Try a different USB port or drive
• Try USB 2.0 keys: If your USB drive doesn’t work, try a USB 2.0 key instead

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

Frequently Asked Questions

Does Selora Homes have access to my customer’s Home Assistant?

No. Selora Homes does not have automatic access to customer installations. All remote access must be explicitly requested and approved by the homeowner through a secure workflow. See our Remote Access for Installers documentation for details on how the request-and-approve process works.

Can Selora Homes see devices on the customer’s network?

No. Selora Homes has no access to cameras, sensors, or any other devices on the customer’s local network. SeloraBox communicates only with Selora Homes infrastructure for health monitoring, configuration updates, and backups. We cannot view, control, or access any devices connected to the customer’s smart home system.

Support

Getting Help

For installation issues or questions:

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