Getting started with Gladys Assistant
It can be difficult to know where to start when you're new to home automation.
Choose Your Home Automation Hub
Gladys Assistant is a self-hosted software, which means everything works locally on a home automation hub. This is one of its main strengths!
You have several options to run Gladys:
Option 1: Mini-PC with Gladys Assistant OS (Recommended)
Most users run Gladys on a mini-PC. It's the best price/performance ratio for a long-term setup.
Installing it is easy with Gladys Assistant OS, our official installer: write it to a USB drive, start the mini-PC from it and answer a few questions. Gladys installs itself, then stays up to date automatically. No command line needed.
- New mini-PC (Beelink, Intel NUC…), for example the Beelink Mini S13 on Amazon
- Refurbished mini-PC: often cheaper on second-hand marketplaces. Look for at least 8 GB RAM and an SSD.
- A computer you already own: an old PC, an Intel NUC gathering dust… A computer with an Intel or AMD processor that starts in UEFI mode, an SSD of at least 16 GB and an Ethernet port can become your Gladys box (its disk will be erased).
👉 Install Gladys on a mini-PC with Gladys Assistant OS
Option 2: Raspberry Pi
- A great way to discover Gladys if you already have one on hand
- Simplified setup with our official 64-bit image (Pi 3, 4, and 5)
- 👉 Raspberry Pi installation guide
- For everyday long-term use, a mini-PC is still the better choice
Option 3: A Server or NAS You Already Run
If you already have a machine running other services, you can install Gladys on it, next to what is already there:
- Any Linux server with Debian or Ubuntu: see the Docker installation guide
- Synology or Unraid NAS: see the Synology and Unraid guides
- Proxmox VE server: run Gladys in a VM installed with Gladys Assistant OS, see the Proxmox installation guide
Installing Gladys Assistant
Depending on the hardware chosen, you can follow one of the following tutorials:
- Recommended: Install Gladys Assistant on a mini-PC with Gladys Assistant OS
- Install Gladys Assistant on a Raspberry Pi
- Install Gladys Assistant with Docker on Debian, Ubuntu or any Linux machine
- Install Gladys Assistant on Proxmox VE
- Install Gladys Assistant on a Synology NAS
- Install Gladys Assistant on an Unraid NAS
Define Your Smart Home Project
The most important thing is to define the automations you want to implement in your home: connected lights, an alarm to secure your home, energy savings by turning off unused devices or heating?
A good way to organize is to create a table (in Excel, Google Sheets, or Notion) where you list all the devices you want to integrate, room by room.

Example: Living Room
| Name | Price | Link |
|---|---|---|
| Zigbee Temperature/Humidity Sensor with Display | $19,99 | Amazon US |
| ZigBee Smart Plug 4 Pack with Real-time Energy Monitoring | €16.99 | Amazon US |
| IKEA TRÅDFRI E27 Bulb (Ceiling Light) | $13,99 | IKEA US |
| IKEA STYRBAR Remote (Brightness) | $13,99 | IKEA US |
| Zigbee Motion Sensor 4 Pack | $75,99 | Amazon US |
The idea is not necessarily to buy everything at once, but rather to plan and gradually equip your home, unless you have just moved in and want to install everything immediately.
Configuring Your Smart Home
Once Gladys is running at your home, you can access it via your web browser and start configuring your home.

From there, just follow the steps: create the main administrator account for your smart home, answer a few preferences, and name your house. It takes a couple of minutes.
There you go! You now have a Gladys smart home system at your place.
You can now set up the various integrations available in Gladys.
If you have any questions, join us now on the forum!