Skip to content

Quick setup

Important notice

Matter support in smart assistant apps is still quite new and the apps still have certain issues. See the current Matter limitations for Apple Home, Google Home, Samsung SmartThings, Amazon Alexa, Home Assistant.

We are working directly with each of their engineering teams to help them provide fixes and bring their support to level expected for large KNX smart homes. With their heavy focus on Matter we expect that soon their Matter integrations will be better and more reliable than their old direct integrations that Matter is replacing.

Table of contents


🎬 Video tutorial

Follow our video instructions on how to set up your 1Home Server.

1. Installation

🎬 Video guide

To start using your device you need to provide it with power and connection to your network.

Connecting to power

There are two options to connect your device to power:

  • A - Auxiliary power: Use the yellow and gray pin to connect to auxiliary power. Normal usage at 30V is around 70-100 mA, max usage is up to 170 mA. Note that if the power supply can't supply enough power for all connected devices it might cause unexpected behavior.
  • B - DC IN power supply: Connect a dedicated 12V, 1A, 12W power supply.

Connect to power

Accessing the dashboard

Once the device is powered on and the STATUS LED light is solid green color 🟢 you can access your 1Home Server at 1home.local URL.

If you have troubles accessing the dashboard, read the Troubleshooting guide.

You should be presented with the login screen as shown below.

Default username and password are printed on the label that you received with the device. Consider changing them after you log in.

Server login page

2. Connecting KNX

🎬 Video guide: Add device manually, ETS auto detection

Connecting to KNX bus

Your device is automatically connected to your KNX bus via the red and black pin.

You can also always add up to 4 additional connections to KNX via KNX IP interfaces. Learn more in the Connect to KNX guide.

You can check the connection status of your device under Integrations -> KNX as shown below. KNX connection status

Adding devices

There are two ways in which you can add your KNX devices:

  1. Auto detect devices from your ETS project file
    • Most of your devices will be automatically detected from your .knxproj file. You will also be able to change the detected devices after the import is finished.
  2. Add KNX devices manually one by one
    • If certain devices were not detected by ETS auto import, you can add them manually.

ETS vs manual

After adding your devices, you will see a list of added devices. With the toggle button on the right side you can select which devices will be bridged to Matter. If you won't use them, we suggest removing them from the dashboard entirely.

List of devices

Now that we have the KNX side ready, let's connect your Matter app.

3. Connecting Matter

🎬 Video tutorial timestamp

Pairing your 1Home Server to Matter apps is stunningly simple.

First you need to enable pairing mode on your 1Home Server. Pairing mode is automatically enabled after the device boots, but is automatically turned off after 15 minutes for security reasons. So it is best to always check if the paring is enabled with the following steps.

1. Enable pairing mode

Click on the Integrations tab. Then under the "Matter bridge" integration click on Configure.

Server integrations

Under "Connected apps (fabrics)" click on Pair button and follow the steps until you see the QR code a shown below.

Matter pairing code

Scanning the QR code in the picture above won't work. 😉

You can now scan your QR code with your favorite Matter app. You can also scan the QR code on the printed label that you have received in the package.

2. Scan the QR code with Matter app

TIP

Note that all Matter apps need a physical hub in your home for Matter to work. This is a necessary step that enables Matter to work locally without needing a cloud connection.

All Matter apps have a very similar pairing workflow. Follow the guide to pair your favorite Matter app:

If you want to re-add or unpair your Matter app make sure to follow our Pair/unpair Matter apps guide, since there are a couple of gotchas to be considered.

That is it!

Now you can start using your Matter capable smart home. 👏 🚀

4. Configure device remotely

If you need to configure your 1Home Server remotely use our remote dashboard for 1Home Server at 🌍 remote.1home.io.

Follow our Remote access guide to get started.