Domoticz – jak zacząć? Instalacja, pierwsza konfiguracja i podstawy obsługi

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

Witaj w świecie inteligentnego domu! Jeśli marzysz o systemie, który pozwoli Ci monitorować temperaturę, kontrolować oświetlenie, zarządzać czujnikami i automatyzować codzienne zadania bez wydawania fortuny na komercyjne rozwiązania, Domoticz to idealny wybór.

To darmowe, open‑source’owe oprogramowanie na Raspberry Pi zamienia Twoją malinkę w potężny hub smart home.

W tym kompletnym poradniku krok po kroku przeprowadzę Cię przez:

• przygotowanie sprzętu i oprogramowania – co kupić, jak dobrać podzespoły i skąd pobrać narzędzia;
• instalację headless – uruchomienie bez monitora i klawiatury, zdalna konfiguracja przez SSH;
• konfigurację sieci i stałego IP – aby zawsze łączyć się pod tym samym adresem;
• instalację Domoticz – prostym, oficjalnym skryptem z kreatorem;
• pierwszą konfigurację w przeglądarce – ustawienia bezpieczeństwa i lokalizacji;
• podstawy obsługi – dodawanie urządzeń i pierwsze automatyzacje.

Poradnik oparty jest na aktualnych metodach (2026), przetestowanych na Raspberry Pi 4/5 i Raspberry Pi OS (dawniej Raspbian). Czas realizacji: ok. 1–2 godziny. Koszt: od 200–300 zł za podstawowy zestaw.

Uwaga: Domoticz jest aktywnie rozwijany – aktualizuj system i aplikację na bieżąco. W 2026 roku oficjalny instalator działa stabilnie na Raspberry Pi OS Bookworm (64‑bit).

1. Co potrzebujesz? Lista sprzętu i oprogramowania

Sprzęt

Przygotuj następujący zestaw:

• Raspberry Pi (zalecane: Pi 4B/5 z 4–8 GB RAM dla płynności; Pi Zero W dla oszczędnych),
• karta microSD (min. 16 GB, klasa 10 lub A1/A2, np. SanDisk Extreme),
• zasilacz USB‑C (5 V/3 A dla Pi 4/5),
• czytnik kart microSD do komputera,
• kabel Ethernet (opcjonalnie, dla stabilniejszej sieci przewodowej) lub moduł Wi‑Fi (wbudowany w Pi 3/4/Zero W).

Oprogramowanie

Aby przygotować kartę i zarządzać systemem, potrzebujesz:

• Raspberry Pi Imager (pobierz z raspberrypi.com/software),
• komputera z Windows/Linux/macOS do przygotowania karty SD,
• przeglądarki internetowej do dostępu do panelu Domoticz.

2. Krok 1 – przygotowanie karty SD (instalacja Raspberry Pi OS)

1. Pobierz i zainstaluj Raspberry Pi Imager na komputerze.
2. Włóż kartę microSD do czytnika.
3. Uruchom Imager:

W Imagerze wykonaj następujące czynności:

• wybierz Raspberry Pi OS (64‑bit) (Bookworm lub nowszy; wersja z desktopem lub Lite dla trybu headless),
• wybierz docelową kartę SD,
• kliknij koło zębate (Advanced options), a następnie:

W Advanced options ustaw poniższe parametry:

• hostname (np. domoticz-pi),
• włącz SSH (z uwierzytelnianiem hasłem),
• login: pi, hasło: ustaw silne, np. TwojeHaslo123! (nie zostawiaj domyślnego raspberry!),
• Wi‑Fi: SSID, hasło oraz kraj PL,
• zapisz ustawienia i wróć do głównego ekranu.

Teraz zapisz obraz systemu na kartę SD:

1. Zapisz obraz na kartę SD i poczekaj 5–10 minut na zakończenie.

Wskazówka headless: w Raspberry Pi Imager pliki SSH i wpa_supplicant.conf tworzą się automatycznie na podstawie ustawień Advanced options.

Wyjmij kartę, włóż do Raspberry Pi, podłącz Ethernet/Wi‑Fi oraz zasilanie. Raspberry Pi uruchomi się automatycznie.

3. Krok 2 – pierwsze logowanie i aktualizacja systemu (SSH)

1. Znajdź adres IP Raspberry Pi w routerze (lub użyj polecenia: ping domoticz-pi.local).
2. Połącz się przez SSH z komputera:

Wykonaj polecenie:

ssh [email protected]
# zamień XXX na właściwe IP Raspberry Pi

Hasło: to, które wcześniej ustawiłeś.

3. Zaktualizuj system i uruchom ponownie:

Wykonaj polecenia:

sudo apt update && sudo apt full-upgrade -y
sudo reboot

4. Rozszerz system plików i ustaw lokalizację (jeśli nie zrobiono w Imagerze):

Uruchom narzędzie konfiguracyjne:

sudo raspi-config

W raspi-config wybierz:

• Advanced Options > Expand Filesystem,
• Localisation Options > Locale i ustaw pl_PL.UTF-8,
• Network Options > Hostname i wpisz domoticz-pi,
• Finish i zrestartuj system, jeśli zostaniesz o to poproszony.

4. Krok 3 – ustaw stały adres IP

Stałe IP ułatwia dostęp do Domoticz (np. zawsze 192.168.1.100:8080).

Edytuj konfigurację klienta DHCP:

sudo nano /etc/dhcpcd.conf

Dla Wi‑Fi (wlan0) wstaw poniższe linie (dostosuj do swojej sieci):

interface wlan0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8

Dla Ethernet (eth0) użyj odpowiednio:

interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8

Zapisz plik (Ctrl+O, Enter, Ctrl+X), a następnie uruchom ponownie Raspberry Pi:

sudo reboot

5. Krok 4 – instalacja Domoticz

Najprościej skorzystać z oficjalnego skryptu instalacyjnego z wbudowanym kreatorem.

Uruchom instalację poleceniem:

curl -L install.domoticz.com | bash

W trakcie działania kreatora odpowiedz na pytania:

• Statyczne IP – potwierdź, jeśli skonfigurowałeś je wcześniej;
• Port HTTP – domyślnie 8080 (zwykle zostawiamy);
• Port HTTPS – domyślnie 443 (certyfikat self‑signed);
• Katalog instalacji – /opt/domoticz (domyślny);
• Wersja – Stable dla początkujących lub Beta dla testerów.

Instalacja trwa zwykle 5–15 minut. Na końcu zobaczysz adresy dostępu, np. http://192.168.1.100:8080 oraz https://192.168.1.100:443.

Aby sprawdzić, czy usługa działa, wykonaj:

sudo systemctl status domoticz

Jeśli instalator nie wystartował, doinstaluj zależności i powtórz:

sudo apt update && sudo apt install -y curl

6. Krok 5 – pierwsza konfiguracja w przeglądarce

1. Otwórz przeglądarkę i wpisz adres serwera: http://192.168.1.100:8080.
2. Jeśli używasz HTTPS, zaakceptuj ostrzeżenie o certyfikacie (self‑signed).
3. W menu Setup > Settings ustaw kluczowe parametry jak poniżej:

Ustawienie	Wartość
Web User	domoticz (lub własny)
Web Password	silne hasło (koniecznie!)
Location	PL, Twoje miasto
Accept new Hardware	Tak
Random Sensor Update	0 (na czas testów)
HTTPS port	443
Apply Settings (prawy górny róg)	zastosuj zmiany

4. Zrestartuj Domoticz po zapisaniu ustawień.

Panel jest gotowy – od teraz możesz dodawać urządzenia i tworzyć automatyzacje.

7. Krok 6 – podstawy obsługi: dodaj pierwsze urządzenia

A. Czujnik temperatury DS18B20 (GPIO)

1. Podłącz czujnik: dane do GPIO4, zasilanie 3.3 V, masa GND.
2. Edytuj konfigurację boot, aby włączyć magistralę 1‑Wire:

Wykonaj polecenie:

sudo nano /boot/config.txt

Dodaj linię i zapisz plik:

dtoverlay=w1-gpio,gpiopin=4

Uruchom ponownie Raspberry Pi:

sudo reboot

3. W Domoticz przejdź do Setup > Hardware, wybierz DS18B20 i kliknij Create.

B. Przykładowe urządzenia i integracje

Poniższa tabela podpowiada, jak dodać popularne kategorie sprzętu:

Typ	Hardware > Create
Dzwonek	Virtual Sensors
Przełącznik	GPIO (moduł przekaźnikowy)
Sonoff/Zigbee	Tasmota / Z‑Stack
Shelly	HTTP/JSON

Automatyzacje – użyj Setup > Events i buduj reguły w Lua lub w edytorze blokowym.

Dashboard – dodawaj widżety (temperatura, wykresy, przyciski) i układaj je metodą „przeciągnij i upuść”.

8. Automatyczny start i podstawowe zabezpieczenia

Domoticz uruchamia się automatycznie (systemd). Zadbaj o hasła i dostęp tylko z zaufanej sieci.

Aby ustawić dostęp do panelu z użytkownikiem i hasłem, możesz użyć:

sudo domoticz -webuser=domoticz -webpass=TwojeHaslo

Aktualizacja Domoticz do najnowszej wersji (zatrzymanie, aktualizacja, start):

sudo systemctl stop domoticz
cd /opt/domoticz
sudo git pull
sudo systemctl start domoticz

Opcjonalnie włącz prosty firewall i otwórz wymagane porty:

sudo apt install ufw
sudo ufw allow 8080/tcp
sudo ufw allow 443/tcp
sudo ufw enable

9. Rozwiązywanie problemów (FAQ)

Najczęstsze problemy i szybkie rozwiązania:

Problem	Rozwiązanie
Brak dostępu	Sprawdź IP (hostname -I) i porty (netstat -tuln).
Instalator nie działa	Zainstaluj brakujące pakiety: sudo apt install curl ca-certificates.
Brak Wi‑Fi	Zweryfikuj konfigurację wpa_supplicant i kraj Wi‑Fi (PL).
Wolna praca	Użyj Raspberry Pi 4/5, rozważ chłodzenie lub umiarkowane podkręcanie.
Baza danych	Kopia zapasowa: sqlite3 /opt/domoticz/domoticz.db ".backup backup.db".

10. Co dalej? Rozwój Twojego smart home

Oto popularne kierunki rozbudowy ekosystemu:

• Integracje – MQTT, Zigbee2MQTT, mostek z Home Assistant;
• Aplikacje mobilne – Domoticz Dashboard na Android/iOS;
• Zaawansowane scenariusze – skrypty Lua, przepływy w Node‑RED;
• Społeczność – forum Domoticz (domoticz.com/forum) oraz polskie smartnydom.pl.