Domoticz instalacja – jak zainstalować system na Ubuntu i rozpocząć konfigurację?

Autor: [Twoje Imię lub Pseudonim] | Data: Maj 2026

Domoticz to jedno z najpopularniejszych, darmowych i open-source’owych rozwiązań do automatyki domowej (smart home). Pozwala na centralne zarządzanie urządzeniami takimi jak termostaty, oświetlenie, rolety, czujniki pogodowe, kamery czy systemy alarmowe. Działa na wielu platformach, w tym na Raspberry Pi, ale świetnie sprawdza się również na serwerach Ubuntu – od lekkich mini-PC po potężne maszyny wirtualne.

W tym rozbudowanym poradniku krok po kroku pokażę, jak zainstalować Domoticz na Ubuntu (wersje 20.04, 22.04, 24.04 LTS i nowsze), skonfigurować go jako usługę systemową oraz rozpocząć podstawową konfigurację. Omówię oficjalny skrypt instalacyjny, alternatywy jak Docker czy Snap, potencjalne problemy i wskazówki dla początkujących. Na końcu znajdziesz sekcję z zaawansowanymi opcjami.

Czas czytania: 15 minut | Poziom trudności: Początkujący/Średniozaawansowany

Dlaczego Domoticz na Ubuntu?

Oto najważniejsze powody, dla których warto wybrać Domoticz na Ubuntu:

• lekki i stabilny – zużywa mało zasobów (min. 512 MB RAM);
• elastyczny – obsługuje protokoły Z-Wave, Zigbee, 1-Wire, MQTT, HTTP i dziesiątki innych;
• webowy interfejs – dostępny z dowolnej przeglądarki (domyślnie port 8080);
• bezpieczny – od wersji 2023.1 domyślne hasło i login (admin/domoticz) – zmień je natychmiast!;
• społeczność – aktywne fora (domoticz.com, polskie smartnydom.pl) i wiki.

Wymagania sprzętowe/programowe

Zanim zaczniesz, upewnij się, że spełniasz minimalne wymagania:

• Ubuntu LTS – 20.04 lub nowsze (oficjalnie minimum 24.04 dla pre-built);
• sprzęt – minimum 1 GB RAM i 1 GHz CPU;
• internet – połączenie wymagane do pobrania pakietów;
• uprawnienia – konto z prawami sudo.

Krok 1 – przygotowanie systemu Ubuntu

Na początek zaktualizuj system i zainstaluj podstawowe narzędzia:

sudo apt update
sudo apt upgrade -y
sudo apt install curl wget unzip -y

Wskazówka – jeśli używasz Ubuntu 24.04+, sprawdź wersję Pythona: python3 --version. Niektóre pluginy wymagają Python 3.8+.

Ustaw statyczny adres IP (zalecane dla serwera smart home), wykonując poniższe kroki:

1. Otwórz do edycji plik Netplan (ścieżka/nazwa mogą się różnić):

sudo nano /etc/netplan/01-netcfg.yaml

2. Wklej i dopasuj przykładową konfigurację do swojej sieci (interfejs, adresy, brama):

network:
version: 2
renderer: networkd
ethernets:
enp0s3: # Zmień na nazwę interfejsu (ip a)
dhcp4: no
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 8.8.4.4]

3. Zastosuj zmiany w konfiguracji sieci:

sudo netplan apply

Krok 2 – instalacja Domoticz (metoda oficjalna – zalecana)

Domoticz udostępnia automatyczny skrypt instalacyjny, który najszybciej przeprowadzi Cię przez proces instalacji. Uruchom go z katalogu domowego:

sudo bash -c "$(curl -sSfL https://install.domoticz.com)"

Co się dzieje podczas instalacji?

W trakcie instalacji zauważysz poniższe etapy i pytania:

• skrypt pobierze najnowszą wersję Domoticz (beta lub release),
• zobaczysz pytania instalatora:
  • port http (domyślnie 8080),
  • włączenie https (port 443, self-signed cert – opcjonalne),
  • uruchomienie jako usługa systemowa,
• instalacja trwa zwykle 2–5 minut.

Po instalacji

Otwórz przeglądarkę i przejdź do adresu panelu: http://TWÓJ_IP:8080 (np. http://192.168.1.100:8080).

Domyślne dane logowania: login admin, hasło domoticz – zmień je natychmiast (Setup > Set Password).

Po zalogowaniu zobaczysz Dashboard Domoticz z możliwością dodawania urządzeń i widgetów.

Problemy podczas instalacji?

Port 8080/443 jest zajęty? Zmień port w kreatorze lub edytuj plik /home/$USER/domoticz/domoticz.sh (zmienna WEBPORT).

Brak biblioteki libusb? Doinstaluj wymagany pakiet: sudo apt install libusb-0.1-4-dev.

Krok 3 – konfiguracja Domoticz jako usługi systemowej

Skrypt instalacyjny zwykle tworzy usługę automatycznie. Jeśli chcesz sprawdzić lub zmienić parametry startowe, edytuj skrypt startowy w katalogu instalacji:

cd ~/domoticz
sudo nano domoticz.sh

Najważniejsze pola konfiguracyjne w pliku skryptu to:

• USERNAME – ustaw na nazwę zwykłego użytkownika (nie root);
• DAEMON – pełna ścieżka do binarium Domoticz (np. /home/yourusername/domoticz);
• DAEMON_ARGS – argumenty startowe, np. -www 8080 dla portu HTTP.

Aby włączyć i uruchomić usługę przy starcie systemu, wykonaj:

sudo chmod +x domoticz.sh
sudo cp domoticz.sh /etc/init.d/
sudo update-rc.d domoticz.sh defaults
sudo systemctl enable domoticz
sudo systemctl start domoticz

Aby sprawdzić status usługi, użyj: sudo systemctl status domoticz.

Restart Domoticz wykonasz poleceniem: sudo systemctl restart domoticz.

Krok 4 – podstawowa konfiguracja interfejsu

Po pierwszym uruchomieniu wykonaj te podstawowe kroki:

1. Zmień hasło administratora – menu: Setup > Set Password.
2. Dodaj urządzenia – menu: Hardware > Create (np. sprzęt „Dummy” do testów) oraz Devices (np. Learn codes dla pilotów RF).
3. Konfiguruj Dashboard – dodaj widgety, takie jak temperatura, przełączniki czy wykresy.
4. Ustaw lokalizację i strefę czasową – menu: Setup > General > Location/Timezone (przydatne dla pogody i harmonogramów).

Pierwsze urządzenie testowe

Dodaj czujnik wirtualny typu „Temperature” w module Hardware/Devices, aby przetestować przepływ danych.

Aby zasymulować odczyt temperatury, wyślij żądanie API do lokalnego serwera Domoticz:

curl "http://localhost:8080/json.htm?type=command&param=udevice&idx=1&nvalue=0&svalue=23.5"

Alternatywne metody instalacji

1. Docker (dla izolacji i łatwego przenoszenia)

Zainstaluj Dockera oraz dodaj użytkownika do grupy docker:

sudo apt install docker.io docker-compose -y
sudo usermod -aG docker $USER # Wyloguj/zaloguj

Uruchom kontener Domoticz (np. obraz kadasz/domoticz):

docker run -d --name domoticz \
--restart=unless-stopped \
-p 8080:8080 \
-v domoticz_data:/opt/domoticz/userdata \
kadasz/domoticz

Zaleta – aktualizacja przez docker pull i ponowne uruchomienie kontenera jest szybka i bezbolesna.

2. Snap (najprostszy dla nowicjuszy)

Zainstaluj pakiet Snap i domoticz-gm, a następnie ustaw port HTTP:

sudo apt install snapd -y
sudo snap install domoticz-gm
sudo snap set domoticz-gm ports.http=8080

Po instalacji przejdź do: http://IP:8080.

3. Kompilacja ze źródeł (dla zaawansowanych)

Jeśli potrzebujesz niestandardowego builda, skorzystaj z kompilacji ze źródeł:

sudo apt build-dep domoticz -y
sudo apt install git build-essential -y
git clone https://github.com/domoticz/domoticz.git
cd domoticz
make

Czas kompilacji zależy od mocy sprzętu (na RPi dłużej).

Aktualizacje i utrzymanie

Poniżej znajdziesz najważniejsze polecenia do aktualizacji i diagnostyki:

• release – cd ~/domoticz && sudo ./updaterelease;
• beta – sudo ./updatebeta;
• logi – bieżący podgląd: tail -f ~/domoticz/domoticz.log.

Najczęstsze problemy i rozwiązania

Jeśli napotkasz trudności, sprawdź poniższe wskazówki:

Problem	Rozwiązanie
Instalacja zawiesza się na Ubuntu 22.04/24.04	Skorzystaj z metod Docker/Snap lub skompiluj ze źródeł.
„Address already in use”	sudo netstat -tulpn | grep 8080 → zatrzymaj kolidujący proces i zmień port w Domoticz.
Brak dostępu z sieci	Skonfiguruj firewall: sudo ufw allow 8080 oraz sprawdź adres IP/trasę.
Wtyczki Python nie działają	Zainstaluj zależności: sudo apt install python3-pip && pip3 install paho-mqtt.
HTTPS nie działa	Skonfiguruj certyfikat Let’s Encrypt (np. przez Certbot) lub reverse proxy.

Bezpieczeństwo

Wzmocnij ochronę swojej instalacji Domoticz, stosując te praktyki:

• zmiana domyślnego hasła – wykonaj ją natychmiast po instalacji;
• https + reverse proxy – np. Nginx z certyfikatem Let’s Encrypt;
• firewall – włącz UFW i zezwól tylko na potrzebne porty: sudo ufw enable && sudo ufw allow ssh,8080.

Co dalej? rozszerzanie systemu

Gdy podstawy działają, rozbuduj środowisko o kolejne elementy:

• integracje – broker MQTT (Mosquitto), Node-RED, mostek z Home Assistant;
• aplikacje mobilne – Domoticz Dashboard na Android/iOS;
• sprzęt – adaptery USB: Z‑Wave (Aeotec Z‑Stick), Zigbee (ConBee II);
• polskie fora – smartnydom.pl, forum.domoticz.com.

Domoticz to solidna baza dla Twojego smart home – od prostego monitoringu po pełną automatyzację. Jeśli masz pytania, komentuj poniżej!

Źródła

Oficjalna wiki Domoticz, fora smartnydom.pl, snapcraft.io.

Artykuł zaktualizowany na maj 2026. Zawsze sprawdzaj kompatybilność z najnowszą wersją Ubuntu.