Domoticz instalacja – krok po kroku na Ubuntu dla początkujących

Autor: [Twoje Imię lub Pseudonim]

Data publikacji: Maj 2026

Witaj w świecie inteligentnego domu! Jeśli zaczynasz przygodę ze smart home i chcesz uruchomić własny system automatyki, Domoticz to świetny wybór.

Domoticz jest darmowy, open‑source i działa znakomicie na Ubuntu – zarówno na starym PC, maszynie wirtualnej, jak i na Raspberry Pi z Ubuntu Server.

W tym poradniku przeprowadzę Cię krok po kroku przez instalację Domoticz na Ubuntu – od zera, bez zbędnych komplikacji.

Dlaczego Ubuntu? To stabilny, darmowy Linux, który uruchomisz praktycznie wszędzie. Domoticz na Ubuntu jest lekki, obsługuje setki urządzeń (czujniki, rolety, termostaty, kamery) i oferuje wygodny, webowy interfejs.

Wymagania wstępne

Zanim zaczniemy, upewnij się, że masz poniższe elementy:

Sprzęt i oprogramowanie

Poniżej znajdziesz minimalne wymagania, które zapewnią płynną instalację i działanie Domoticz:

• Ubuntu 20.04 LTS lub nowszy – rekomendowane Ubuntu 22.04 LTS dla stabilności;
• min. 1 GB RAM i ok. 2 GB wolnego miejsca na dysku – im więcej urządzeń, tym większe zapotrzebowanie;
• procesor x86_64 lub ARM (np. Raspberry Pi z Ubuntu Server);
• stałe połączenie z internetem – do pobrania pakietów i aktualizacji.

Narzędzia

Do instalacji i podstawowej konfiguracji przydadzą się:

• Terminal – wbudowany w Ubuntu;
• edytor tekstu nano – prosty i domyślnie dostępny;
• klient SSH (opcjonalnie) – np. PuTTY na Windows, jeśli łączysz się zdalnie.

Uwaga dla początkujących: jeśli nie masz jeszcze Ubuntu, pobierz obraz z oficjalnej strony: https://ubuntu.com/download/desktop i zainstaluj na maszynie wirtualnej (np. Oracle VirtualBox – darmowy).

Krok 1 – aktualizacja systemu Ubuntu

Zacznij od aktualizacji pakietów, aby uniknąć konfliktów zależności:

1. Otwórz Terminal (skrót: Ctrl + Alt + T).
2. Wykonaj polecenia aktualizacji:

sudo apt update
sudo apt upgrade -y


Co robią te komendy:

• sudo apt update – odświeża listę dostępnych pakietów;
• sudo apt upgrade -y – instaluje najnowsze aktualizacje.

3. Jeśli system dawno nie był aktualizowany, możesz użyć pełniejszej aktualizacji, a po niej zrestartować maszynę:

sudo apt dist-upgrade -y
sudo reboot


Szacowany czas: 5–10 minut.

Krok 2 – konfiguracja statycznego adresu IP (zalecane)

Stały adres IP ułatwia dostęp do Domoticz w sieci lokalnej. Poniżej przykład konfiguracji dla Netplan (Ubuntu 20.04+):

1. Otwórz plik konfiguracyjny Netplan:

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


Jeśli pliku nie ma, sprawdź zawartość katalogu: /etc/netplan/ i użyj właściwej nazwy.

2. Wklej i dostosuj poniższą konfigurację do swojej sieci:

network:
version: 2
renderer: networkd
ethernets:
enp0s3: # Zmień na właściwy interfejs (sprawdź: ip a)
dhcp4: no
addresses: [192.168.1.100/24] # Statyczny adres IP
routes:
- to: default
via: 192.168.1.1 # Brama (IP routera)
nameservers:
addresses: [1.1.1.1, 8.8.8.8]


Aby sprawdzić nazwę interfejsu sieciowego, użyj polecenia:

ip a


3. Zastosuj zmiany i zweryfikuj adres IP:

sudo netplan apply
ip a


Dla Wi‑Fi użyj sekcji wifis zamiast ethernets i dodaj SSID oraz hasło w polu access-points.

Szacowany czas: 2–5 minut.

Krok 3 – instalacja niezbędnych narzędzi i zależności

Przygotuj system do uruchomienia instalatora oraz ewentualnej kompilacji dodatków:

1. Zainstaluj podstawowe narzędzia i biblioteki:

sudo apt install -y curl ca-certificates build-essential libssl-dev


Ważne: nie dodawaj starych repozytoriów (np. „xenial-security”) tylko po to, by uzyskać przestarzałe wersje OpenSSL. W nowszych Ubuntu instalator Domoticz oraz budowa ze źródeł działają z bieżącymi bibliotekami.

Szacowany czas: 3–5 minut.

Krok 4 – instalacja Domoticz oficjalnym skryptem

Najprostsza metoda to użycie oficjalnego instalatora. Poniższe polecenie pobierze i uruchomi skrypt z uprawnieniami administratora:

1. Uruchom instalator Domoticz:

curl -sSL https://install.domoticz.com | sudo bash


W trakcie instalacji wybierzesz kluczowe ustawienia, takie jak folder instalacji (/opt/domoticz) i port HTTP (domyślnie 8080).

2. Po zakończeniu sprawdź status usługi i włącz autostart:

sudo systemctl status domoticz.service
sudo systemctl enable --now domoticz.service


3. Jeśli pojawiły się błędy, zaktualizuj system i spróbuj ponownie:

sudo apt update && sudo apt upgrade -y
curl -sSL https://install.domoticz.com | sudo bash


Szacowany czas: 5–15 minut (zależnie od łącza i sprzętu).

Krok 5 – pierwsze uruchomienie i podstawowa konfiguracja

Po instalacji otwórz przeglądarkę i wejdź pod adres serwera z portem 8080:

http://TWÓJ_ADRES_IP:8080


Domyślnie Domoticz nie wymaga logowania. Dla bezpieczeństwa od razu ustaw hasło administratora i ewentualnie nazwę użytkownika w ustawieniach WWW.

Na start wykonaj poniższe działania konfiguracyjne:

• Ustawienia → Ustawienia – włącz uwierzytelnianie (user/hasło), ustaw język polski, strefę czasową oraz jednostki (°C, km/h);
• Ustawienia → Serwer WWW – potwierdź lub zmień port HTTP (domyślnie 8080) i skonfiguruj HTTPS, jeśli planujesz dostęp zdalny;
• Sprzęt (Hardware) → Dodaj – dodaj kontrolery i bramki, np. MQTT, Z‑Wave, Zigbee;
• Ustawienia → Pokoje – utwórz pokoje i przypisz do nich urządzenia;
• Kopia zapasowa – skonfiguruj automatyczny backup ustawień i bazy (menu Ustawienia).

Domoticz startuje automatycznie wraz z systemem (usługa systemd).

Alternatywna metoda – budowa ze źródeł (gdy skrypt zawiedzie)

Jeśli korzystasz z bardzo nowej wersji Ubuntu (np. 24.04) lub instalator nie działa, zbuduj Domoticz lokalnie:

1. Zainstaluj zależności kompilacyjne:

sudo apt install -y git build-essential cmake libssl-dev libcurl4-openssl-dev \
libusb-1.0-0-dev zlib1g-dev libsqlite3-dev


2. Pobierz kod i uruchom skrypty budowy:

git clone https://github.com/domoticz/domoticz.git
cd domoticz
sudo ./do_compile.sh
sudo ./do_install.sh


Szczegóły znajdziesz w dokumentacji projektu: https://www.domoticz.com/wiki/Build_Domoticz_from_source

Rozwiązywanie problemów

Jeśli napotkasz trudności, poniższa tabela pomoże szybko zlokalizować typowe usterki i je usunąć:

Problem	Rozwiązanie
Brak dostępu do panelu WWW	Sprawdź zaporę: sudo ufw allow 8080/tcp. Zweryfikuj usługę: sudo systemctl status domoticz.service. Sprawdź IP: ip a.
Błędy OpenSSL/libssl przy kompilacji	Zainstaluj zgodne nagłówki: sudo apt install -y libssl-dev. Na nowszych Ubuntu kompiluj ze źródeł zgodnie z sekcją alternatywną.
Instalator kończy się bez zmian	Zaktualizuj system i certyfikaty: sudo apt update && sudo apt upgrade -y && sudo apt install -y ca-certificates curl, a następnie uruchom instalator ponownie.
Port 80/443 jest zajęty	Zmień port w Domoticz: Ustawienia → Serwer WWW, zapisz i zrestartuj usługę: sudo systemctl restart domoticz.service.
HTTPS nie działa	Skonfiguruj certyfikat Let’s Encrypt za pomocą reverse proxy (np. Nginx/Caddy) lub wgraj własny certyfikat w ustawieniach WWW Domoticz.
Wolne działanie na słabym sprzęcie	Dodaj swap: sudo fallocate -l 1G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile, ogranicz logowanie i wyłącz zbędne wtyczki.

Podgląd logów ułatwi diagnostykę:

sudo journalctl -u domoticz.service -f


Jeśli skonfigurowano plik logu, sprawdź również: /opt/domoticz/domoticz.log.

Dodatkowe wskazówki dla smart home

Oto kilka praktycznych porad, które usprawnią Twoją instalację:

• Integracje – do MQTT zainstaluj mosquitto (sudo apt install mosquitto), dla Zigbee skorzystaj z Zigbee2MQTT lub ZHA;
• Backupy – regularnie eksportuj kopię ustawień i bazy z poziomu Ustawień;
• Aktualizacje – utrzymuj system i Domoticz w aktualnej wersji (np. skryptem aktualizującym lub z repozytorium projektu);
• Bezpieczeństwo – włącz uwierzytelnianie, ustaw HTTPS lub reverse proxy, skonfiguruj zaporę ufw i rozważ dostęp przez VPN;
• Wtyczki i rozszerzenia – instaluj sprawdzone pluginy (np. Broadlink, Sonoff) w katalogu /opt/domoticz/plugins/ i monitoruj ich wpływ na wydajność.

Polecane zasoby

Jeśli chcesz pogłębić temat, zajrzyj do poniższych materiałów:

• oficjalna strona Domoticz: https://www.domoticz.com/
• dokumentacja instalacji: https://www.domoticz.com/wiki/Installing_Domoticz
• forum społeczności: https://forum.domoticz.com/