Itâs official: Gladys Assistant OS is available!
This is the new official way to install Gladys on a mini-PC: you write the image to a USB key, you boot the mini-PC from it, you answer a few questions, and Gladys installs itself. No more command line, no more docker run to copy-paste
Everything is explained step by step, with a screenshot of each screen, in the new documentation:
What Gladys Assistant OS does
Under the hood, itâs a standard Ubuntu Server 26.04 LTS, prepared for Gladys
The installer only asks for the language, the keyboard, and your account. With a single disk, thereâs not even a disk to choose
On first boot, it installs Docker, downloads the latest version of Gladys, and launches it. You can follow the progress on the mini-PC screen or from your phone
Gladys updates itself, and Ubuntu installs its security updates automatically
An Internet or power outage during the first boot? It resumes where it left off
And itâs not a black box: it remains a classic Ubuntu, accessible via SSH, with no default account or password.
What you need for this first version
an Intel or AMD mini-PC (x86-64) that boots in UEFI, which is almost all mini-PCs
an Ethernet cable
a screen and a keyboard, only during installation
On Raspberry Pi, we keep the Raspberry Pi image, and the Docker installation remains for those who already have a server or a NAS. And if Gladys is already running at your place, nothing changes: no need to reinstall!
All the installation documentation revised
I took the opportunity to revise all the installation documentation (in French, English, German, and Spanish) so that Gladys Assistant OS is the first thing we see:
This is a first version: if you have a mini-PC on hand, install it and tell us how it went in a reply to this post! Every feedback on real hardware (Intel N100/N150, Core, AMD Ryzen, NVMe, SATAâŠ) helps to make the installer more reliable. The test checklist is here: HARDWARE-TEST-CHECKLIST.md
Donât hesitate to give your feedback on the forum
Iâll take this opportunity to clarify: if you already have Gladys Assistant installed, this doesnât concern you. Itâs mainly useful for new users
Gladys Assistant OS is nothing more than Ubuntu Server + Docker + Gladys + Watchtower, so nothing new if you followed the Docker tutorial: you already have the same thing at home, no need to reinstall! The only difference is that everything installs automatically, without command lines.
This is perfect timing, I ordered a new mini-PC thatâs arriving in a few days! So Iâm really happy to start with Gladys OS.
Replacing the mini-PC because with the current one, which only has 8GB of RAM and is a 2015 model, itâs becoming borderline to manage my installation: Iâm at 200 devices (including virtual MQTT devices and devices from external integrations), 300 scenes most of which are based on a trigger, 35 external integrations installed, and a database that takes up 8GB on the hard drive.
I donât know if itâs a very large installation, but in any case, it has become too large for my little mini-PC.
I know the documentation says in two places that the mini-PC must be connected to the network via Ethernet. But I made a mistake and didnât do it⊠The installation then proceeds completely until this screen appears indicating that the Ethernet connection is missing:
I tried plugging in the cable, but it was too late; a configuration was probably not done correctly. I restarted the entire procedure with the cable plugged in and everything ended well.
Perhaps the absence of an Ethernet network should be detected before starting the installation?
Thank you again for this detailed feedback, it helped me find the cause of the two issues
You were right: it was a real bug. When the mini-PC does not get a network address at the beginning of the installation, the Ubuntu installer does not configure any network card on the installed system. Plugging in the cable afterward was therefore useless, although the « Internet Connection Required » screen suggested otherwise.
If the installation is done without a cable, Gladys Assistant OS now activates the network on all Ethernet ports: you can plug in the cable afterward, on any port, and the installation resumes on its own. Rather than blocking the installation without a network, I preferred that it works in this case. The fix will be in the next version; in the meantime, you need to plug in the cable before starting the installation.
These screens come from the Ubuntu installer, not from Gladys, and its French translation is incomplete: about half of the texts are missing. Most are translated on Launchpad, but Canonical has not integrated them since October 2023. We cannot fix them on our side, as they are in the installer signed by Canonical.
Thanks for the PR @cicoub13, itâs great! I added a comment on Github because I thought of a scenario: some mini-PCs have 2 Ethernet ports (for example on some Beelink S13), and both ports need to work because you donât always remember which port you used during installation
Claude suggested a fix, but itâs not necessarily the only solution, the main thing is just that both ports can work!
Hello,
Iâm responding to myself to share my experience installing Gladys OS on a mini PC.
I had a Gladys Assistant installation on a Raspberry Pi 4 that was starting to slow down, but I didnât want to invest too much, so I limited myself to a Beelink mini s12.
I proceeded to install Gladys OS on it without any issues.
A bit of sweat during the installation because I had connected the mini PC to a powerline adapter, being quite far from the router and not having an Ethernet port nearby.
At one point, I lost the internet connection (powerline adapter issue) while downloading Gladys OS.
I went to look for a long enough Ethernet cable to plug it directly into my router, and the installation resumed without any issues (despite a pause of about a quarter of an hour, the time it took to find the cable).
Reboot after removing the installation key and everything is fine.
SSH access from my laptop operational and access to the Gladys interface without any problems.
Then, a small concern when I wanted to move my mini PC to replace my Raspberry Pi.
No network connection and the LEDs on my Ethernet port were off.
As I was replacing the Raspberry Pi, which was accessible, I did not question the Ethernet cable it was connected to at all.
I then struggled for a while to figure out where this could be coming from, but I still replaced the Ethernet cable (one end was broken so it didnât hold very well) to realize that was all it was.
In the end, the installation went smoothly.
Then, it was my mistake: I wanted to restore my old Gladys configuration that I had previously saved (or so I thought).
When trying to restore it, there was no way to find this backup. And to top it off, I couldnât restart my Raspberry Pi, so I started from scratch for the Gladys installation.