> For the complete documentation index, see [llms.txt](https://luum.io/llms.txt).
> Canonical page: [Quick Start Guide](https://luum.io/docs/amatis/programming/quick-start).

LUUM.IO

# **Quick Start Guide** - GUIDE

## About This Guide

Welcome to the quick start programming guide for the Amatis Lighting Controls System and the XS-100 Series X-PoE lighting controller! In this guide, we will program a location with X-PoE lighting loads, wall switches, and motion sensors. We will cover how to configure the lighting loads for maximum compatibility with the X-PoE system, demonstrate how to zone the lighting loads and controls appropriately, and finally activate motion and wall switch controls.

> **Note**
> Though this guide features the XS-100 Series X-PoE lighting controller, it is applicable to any Luum.io or Amatis load controller and/or wireless device.
>
## Necessary Parts

The following parts will be necessary to complete this guide:

1. A functional IP network
2. An X-PoE lighting controller with lighting loads
3. An Amatis Border Router (AMBR)
4. An Amatis wireless rocker switch and sensor

> **Note**
> This guide shows two wireless wall switches and one wireless sensor already configured with the X-PoE host.
>
## System Setup

Before getting started with the system configuration, ensure the devices are properly connected. The AMBR and X-PoE lighting controllers should all have power and be connected to the same network. Any wired or wireless controls should also be powered up. Once all devices have power and are online, begin by logging into the [Amatis Configuration App](https://app.amatiscontrols.com).

> **Note**
> This guide only applies to new out of the box devices. Used devices may not be able to communicate with each other if they have been set up incorrectly, and will need to be reset.
>
![luum.io cloud login](https://luum.io/guides/assets/quick-start-guide/cloud_login.png)

## New User Or Site

If a new user is attempting to access the system, create an account. Once logged in, if a site has not been created yet, follow these steps:

1. Select “Create a new Site”:

    ![create_site](https://luum.io/guides/assets/quick-start-guide/create_site.png)

2. Type in the Device ID. It is printed on the packaging and on the bottom of the AMBR. Give the site a name, and enter the site's zip code:

    ![create_new_site](https://luum.io/guides/assets/quick-start-guide/create_new_site.png)

> **Note**
> If you get an “AMBR not found” message:
> 
>
> - Ensure that the AMBR and the connected router have access to the internet and it’s not behind a firewall. For OPC commissioning instructions, contact [Luum Support](mailto:support@luum.io).
>
> - Ensure your AMBR wasn’t hard coded for another site previously. If it was, factory reset it with Button B. See the [AMBR Install Guide: Button Operation](https://luum.io/docs/amatis/install-guides/ambr#button_operation).
>
## Step 1: Create Location

After logging in, navigate to the "Locations" section and choose "Add New Location" to create the first location:

![luum.io home page](https://luum.io/guides/assets/quick-start-guide/room_tab.png)

Select the type of location, give it a name, and click "Create":

![room creation](https://luum.io/guides/assets/quick-start-guide/room_creation.png)

The location has now been created and is ready for devices to be added.

## Step 2: Add Devices To Location

Once the location is created, devices should be added to the location. Select "Add Devices" to begin adding devices to the location:

![add device button](https://luum.io/guides/assets/quick-start-guide/add_device_button.png)

Select all of the devices in the location, and click "Add Selected Devices":

![add devices](https://luum.io/guides/assets/quick-start-guide/add_devices.png)

> **Note**
> When adding devices with multiple inputs or outputs, only add the inputs and outputs themselves, and not the overall device.
>
> **Note**
> If an X-PoE device is not showing up, refer to the [X-PoE Amatis Integration Guide](https://luum.io/docs/amatis/programming/xpoe-amatis-integration).
>
The device have now been added to the location and are ready for configuration.

## Step 3: Device Configuration

After a location has been created and devices have been added to the location, the next step is to configure device-specific properties. Make sure the "Devices" tab is selected, select the three dots next to a device, and click "Open Device Details" to configure it:

![open device details](https://luum.io/guides/assets/quick-start-guide/open_device_details.png)

The settings pertaining to the specific device can be configured here if necessary:

![device details](https://luum.io/guides/assets/quick-start-guide/device_details.png)

In this example, zero offset, min out, and max out for an X-PoE channel are show.

In this example, zero offset, min out, and max out for an X-PoE channel are show.

> **Note**
> Device configuration is not necessary for every device and may be done at any time. Not all devices will have the same settings.
>
The devices have now been configured and are ready to be grouped into zones.

## Step 4: Zoning Devices

Once the necessary devices have been configured, the next step is to group the devices into controlled zones. Make sure the "Devices" tab is selected, select the devices and controls to be grouped into a zone, and select "move" at the bottom of the screen:

![select for zoning](https://luum.io/guides/assets/quick-start-guide/select_for_zoning.png)

> **Note**
> Motion sensors cannot be added to both locations and zones. By default, if there is a motion sensor in a location, it will control all zones in the location. Zones can be removed from motion control in the zone config.
>
Begin typing the name of the zone. Select the zone from the dropdown or select "Add [zone name] zone" if it is a new zone:

![zones](https://luum.io/guides/assets/quick-start-guide/zones.png)

Repeat this process until all devices (except motion devices, see note above) are grouped into zones. The zones are now ready to be configured.

## Step 5: Zone Configuration

After the devices have been grouped into zones, the zones need to be configured for control. Make sure the "Configuration" tab is selected. Configure the desired controls for the location (if applicable) and each zone:

![zone config](https://luum.io/guides/assets/quick-start-guide/zone_config.png)

> **Note**
> Apply any changes to a zone before configuring the next zone.
>
## Step 6: Sync Changes

Once configuration is complete, the changes need to be saved to the devices. Select the "Sync" button from the upper right menu:

![sync](https://luum.io/guides/assets/quick-start-guide/sync.png)

After all devices have saved, the X-PoE system configuration is complete! For scene editing and multi-button input triggers, see the [Custom Programming Guide](https://luum.io/docs/amatis/programming/custom-programming). For Configuration-tab setup, including dimmer trim, occupancy, grace period, slider, switch, and daylight settings, see the [Advanced Programming Guide](https://luum.io/docs/amatis/programming/advanced-programming).

## Related Information

### Programming Guides

- [Custom Programming Guide](https://luum.io/docs/amatis/programming/custom-programming) — scene editing and multi-button input triggers.
- [Advanced Programming Guide](https://luum.io/docs/amatis/programming/advanced-programming) — Configuration-tab settings.

### Technical Support

Questions about this quick start can be sent to [support@luum.io](mailto:support@luum.io). Include the site and the step you are on.

### Document Feedback

While we have taken great care to ensure the accuracy and completeness of this document, we welcome your feedback and suggestions. If you notice any errors or omissions, or feel a topic could benefit from further explanation, please email your feedback to [support@luum.io](mailto:support@luum.io).

### Revision History

| Date | Revision | Notes |
| --- | --- | --- |
| 11/17/2026 | B | Linked scene editing and multi-button inputs to the [Custom Programming Guide](https://luum.io/docs/amatis/programming/custom-programming), and Configuration-tab setup to the [Advanced Programming Guide](https://luum.io/docs/amatis/programming/advanced-programming). Updated guide references throughout this page to public Help Center links. |
| 11/3/2026 | A | Converted to the current guide format. |

### Disclaimer

All rights, title, and interest in and to this guide, including without limitation all copyright, trademark, patent, trade secret, and other proprietary rights, belong solely and exclusively to Luum.io and/or its licensors. This guide is provided solely for the purpose of programming a new Amatis or X-PoE location, and no license or other rights are granted or implied hereby. No part of this guide may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of Luum.io. The contents of this guide are subject to change without notice. The information contained herein is provided on an 'as is' basis and is for informational purposes only. Luum.io makes no warranty, express or implied, as to the accuracy, completeness, or usefulness of this information, nor does it assume any legal liability or responsibility for the consequences of any errors or omissions therein. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

---

_©2026 Luum.io. All rights reserved._
