First run

A fresh install opens with a wizard, not an empty screen. The wizard has four steps, and any of them can be put off: “Later” takes you to the plan, and you can come back to setup at any time.

Where to start

• New flat — a template with one, two or three rooms. Then the wizard connects Home Assistant and places the first light.
• Connect your Home Assistant — server address and a long-lived access token (Profile → Security → Long-lived access tokens → Create token). After connecting — the same template choice.
• I have an invite — the home is already set up on another device. Scan the QR code with the camera or type the code. When typing the code by hand, enter the Homer server address (http://<address>:8730): the QR code already has it. An owner who comes into a home without a plan goes to the template choice.
• Home from file — a plan exported from Homer or built from a drawing (.json, .homer).

Flat templates

Template	Rooms	Area
1 room	hallway, bathroom, kitchen, room	38 m²
2 rooms	hallway, bathroom, kitchen, bedroom, living room	55 m²
3 rooms	hallway, bathroom, toilet, kitchen, living room, bedroom, kids' room	74 m²

A template is a starting point. Room sizes, walls, doors and windows are edited in the plan editor: Arrange mode → Edit walls. “Blank sheet” starts with one floor and no rooms.

First light

• Zigbee light — opens the Zigbee network: turn on the new light and it's found by itself. See Zigbee.
• Light from Home Assistant — a list of lights already connected to HA.
• Virtual light — if you don't have a real one at hand. The Homer server puts the homer_demo_lamp.yaml package into Home Assistant: a template light that turns on, off and changes brightness like a real one. The owner adds it, and the server needs package deployment (HA_PACKAGES_DIR). To remove it, take the light off the plan and delete the package: with the owner request DELETE /v1/onboard/demo-lamp or with the homer_packages tool in Claude Code.

Tips on the plan

After the wizard, the plan shows five tips one at a time: a light as a button, rooms, the three home views, editing, adding devices and access for family. “Skip” removes them at once.

In the web version, the same wizard opens for the owner or an editor in a home without rooms: template and first light.