Skip to content

Commit

Permalink
Add smart home ultimate guide EN
Browse files Browse the repository at this point in the history
  • Loading branch information
@Pierre-Gilles
Pierre-Gilles committed Nov 27, 2023
1 parent 73eac9a commit f84046d
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 17 deletions.
56 changes: 45 additions & 11 deletions docs/installation/0_hardware.md
View file
Original file line number Diff line number Diff line change
@@ -1,24 +1,58 @@
---
id: hardware
title: Recommended hardware
sidebar_label: The hardware
title: Smart Home - The ultimate guide for beginners
sidebar_label: The ultimate smart home guide
slug: /
---

Gladys Assistant is a program that runs on any Linux machine: a PC running Ubuntu, a Raspberry Pi, a NAS, a VPS, a server...
It's hard to know where to start when you're new to home automation. What equipment should you choose? For what budget? Which home automation protocol to use?

Let's summarize the different options:
I've put together this tutorial to cover all these points and give you a starting point for creating your connected home from scratch.

- **A PC running Ubuntu**: More and more users are running Gladys on a mini-PC, like a Dell Optiplex 3040, an Intel NUC, a mini-PC Beelink or any Linux computer. These machines are very stable, durable, and are not that expensive when taking everything into account. In my opinion, in 2023, this is one of the most interesting options to install Gladys.
## Defining your smart home project

[How to install Gladys with Docker on a PC](/docs/installation/docker/).
The most important thing is to define the automation systems you want to install in your home: connected lights? An alarm to secure your home? Save energy by switching off unused appliances/heating?

- **A Raspberry Pi**: It is possible to install Gladys on a Raspberry Pi with our ready-made Raspberry Pi OS image. However, with the shortage of semiconductors, Raspberry Pi's are hard to find and have become very expensive! We don't recommend using a micro-SD to store your data (because micro-SDs are very easily corrupted), you have to use an SSD. This manipulation is not necessarily easy to do, and from the moment you connect an SSD + a Zigbee dongle for example, you can have power supply problems because the Pi is not made to connect so many devices. That's why today, using a mini-PC can be a simpler and more stable option.
Personally, I like to draw up a table (in Excel, Google Sheet or Notion) broken down by room, listing all the appliances I want to install.

[How to install Gladys on a Raspberry Pi](/docs/installation/raspberry-pi/).
For example:

- **A NAS** : Gladys runs on a NAS, either a Unraid NAS ([tutorial here](/docs/installation/unraid/)), or a Synology NAS ([tutorial here](/docs/installation/synology/)).
**Living Room**

A NAS is often a very stable, durable machine. It is a very good option to start with Gladys.
| Name | Price | Link |
| --------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Door opening sensor | 10,06€ | [Domadoo](https://www.domadoo.fr/fr/peripheriques/5320-sonoff-capteur-d-ouverture-de-portefenetre-zigbee-30-snzb-04-6920075776126.html?domid=17) |
| Temperature/Humidity sensor | 10,91€ | [Domadoo](https://www.domadoo.fr/fr/peripheriques/6614-sonoff-capteur-de-temperature-et-d-humidite-zigbee-30-avec-ecran.html?domid=17) |
| Rolling shutters Zigbee | 39,92€ | [Domadoo](https://www.domadoo.fr/fr/peripheriques/5245-sunricher-module-volet-roulant-zigbee-30.html?domid=17) |
| Smart Power Plug with power consumption | 16,99€ | [Domadoo](https://www.domadoo.fr/fr/peripheriques/6165-nous-prise-intelligente-zigbee-30-mesure-de-consommation-5907772033517.html?domid=17) |
| Ampoule IKEA Tradfi E27 with color | 17,99€ | [IKEA](https://www.ikea.com/fr/fr/p/tradfri-ampoule-led-e27-806-lumen-connecte-sans-fil-a-variateur-dintensite-spectre-couleur-et-blanc-globe-70439158/) |
| IKEA STYRBAR remote control | 9,99€ | [IKEA](https://www.ikea.com/fr/fr/p/styrbar-telecommande-connecte-blanc-30488363/) |
| Motion sensor - Zigbee Aqara P1 | 24,99€ | [Domadoo](https://www.domadoo.fr/fr/peripheriques/6138-aqara-detecteur-de-mouvement-et-luminosite-zigbee-30-aqara-motion-sensor-p1-ms-s02-6970504215979.html?domid=17) |

If you have any questions about the hardware to use, come and ask us on the [online community](https://en-community.gladysassistant.com/).
## Choosing your smart home hub

Gladys Assistant is "self-hosted" software, which means that everything will run locally on your home automation box.

That's Gladys' strength!

Gladys runs on any Linux mini-PC:

| Model | Price | Comment | Link |
| ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Raspberry Pi 4 | 56,90€ | The best-known and most affordable board on the market. Easy to set up with our Raspberry Pi OS image. Beware, using a micro-SD can present risks in the long term (risk of disk corruption). Perhaps a good entry point for getting started on Gladys at low cost! | [Kubii](https://www.kubii.com/fr/cartes-raspberry-pi/2771-nouveau-raspberry-pi-4-modele-b-2gb-3272496308794.html?gladys) |
| Khadas VIM1S | 65,99€ | A card with integrated eMMC storage. 2GB RAM / 16GB storage. Installation of Ubuntu Server via their custom BIOS, then installation of Gladys in CLI with Docker. | [Amazon](https://amzn.to/3suD6Z3) |
| Beelink Mini S12 Pro | 185€ | A super-powerful mini-PC: low-power 12th-generation Quad Core Intel, 8/16GB RAM, 256/512GB NVMe SSD. Extremely stable over the long term, and very high-performance. Little fiddling to do (it's all integrated in a case, and power supplied). To use it, install Ubuntu Server via a bootable USB key + install Gladys via Docker. | [Amazon](https://amzn.to/49RNnPI) |
| Any server, NAS, mini-PC | | Do you have a Synology NAS? An Intel NUC? Any Linux server, as long as it can run Docker, can run Gladys. Don't hesitate to come to the forum if you have any questions. | |

## Installing Gladys Assistant

Depending on the box you've chosen, you'll need to use either:

- Our Raspberry Pi OS image: [Installation on Raspberry Pi](/docs/installation/raspberry-pi/)
- Our [Docker installation tutorial](/docs/installation/docker/)

## Configuring your connected home

Once Gladys is running in your home, you'll be able to access it via your web browser.

If you have any questions, reach us on [Gladys Assistant Forum](https://en-community.gladysassistant.com/) !
6 changes: 0 additions & 6 deletions docs/installation/1_raspberry-pi.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,6 @@ sidebar_label: Raspberry Pi

If you are looking to install Gladys Assistant on a Raspberry Pi that is already configured, use the [Docker](/docs/installation/docker) tutorial.

:::note
With the current Raspberry Pi shortage, a good alternative would be to run Gladys on a mini-PC like a Dell OptiPlex 3040, a Beelink mini-PC or an Intel NUC.

Those mini-PC runs natively on a SSD so they are usually very stable to use.
:::

## Download Gladys Raspberry Pi OS image

We provide a pre-built Raspberry Pi OS image with Gladys already configured.
Expand Down

0 comments on commit f84046d

Please sign in to comment.