Instalacja#

vCLU to pojedynczy plik binarny (~13 MB). Nie wymaga Dockera, Node.js, Pythona ani żadnych zewnętrznych zależności. Instalacja zajmuje kilka minut.

Metoda 1: Gotowy pakiet (zalecana)#

Pobierz archiwum dla swojej platformy z releases:

tar -xzf vclu-linux-arm64.tar.gz
cd vclu-linux-arm64
sudo ./install.sh

Co robi install.sh#

Skrypt instalacyjny wykonuje następujące kroki:

Tworzy katalogi /opt/vclu/ i /opt/vclu/data/
Kopiuje plik binarny vclu do /opt/vclu/
Kopiuje katalogi web/ (panel webowy) i runtime/ (pliki Lua) do /opt/vclu/
Instaluje usługę systemd (vclu.service)
Włącza autostart i uruchamia usługę

Po instalacji vCLU działa jako usługa systemowa i uruchamia się automatycznie po restarcie.

Metoda 2: Kompilacja ze źródeł#

Wymagany Go 1.22+.

# Klonowanie repozytorium
git clone https://github.com/vclu-pl/vclu.git
cd vclu

# Kompilacja i uruchomienie
go build -o vclu ./cmd/vclu
./vclu --auto --data-dir ./data

Flaga --auto automatycznie tworzy katalog danych i domyślną konfigurację.

Cross-kompilacja na Raspberry Pi#

Jeśli rozwijasz na macOS lub Linux x86, a docelowa platforma to Raspberry Pi:

GOOS=linux GOARCH=arm64 go build -o vclu-linux-arm64 ./cmd/vclu

Dla starszych Raspberry Pi 1 / Zero (32-bit ARM):

GOOS=linux GOARCH=arm GOARM=6 go build -o vclu-linux-arm ./cmd/vclu

Metoda 3: Docker#

docker run -d \
  --name vclu \
  --network host \
  -v vclu-data:/opt/vclu/data \
  ghcr.io/vclu-pl/vclu:latest

Flaga --network host jest wymagana. vCLU potrzebuje bezpośredniego dostępu do sieci dla:
UDP broadcast na porcie 1234 (discovery Grenton OM)
mDNS (discovery HomeKit)
Bez --network host discovery nie będzie działać.

Szybki deploy na Raspberry Pi#

Skrypt build-and-deploy.sh automatyzuje cały proces: cross-kompiluje, kopiuje przez SCP i instaluje usługę systemd:

./build-and-deploy.sh --host 192.168.1.100 --user pi

Skrypt wykrywa architekturę docelową i dobiera odpowiednie flagi kompilacji.

Obsługiwane platformy#

Platforma	Architektura	Status
Raspberry Pi 1 / Zero	arm (32-bit)	Działa - wolniejszy start (~8s)
Raspberry Pi 2 / 3	arm / arm64	Działa bez problemów
Raspberry Pi 4 / 5	arm64	Rekomendowane
Linux x86 (NAS, VM, VPS)	amd64	Działa
macOS (Apple Silicon)	arm64	Development
macOS (Intel)	amd64	Development

Po instalacji#

Zarządzanie usługą#

# Status
sudo systemctl status vclu

# Restart
sudo systemctl restart vclu

# Zatrzymanie
sudo systemctl stop vclu

# Wyłączenie autostartu
sudo systemctl disable vclu

Logi#

# Bieżące logi
sudo journalctl -u vclu -f

# Ostatnie 100 linii
sudo journalctl -u vclu -n 100

# Logi z ostatniej godziny
sudo journalctl -u vclu --since "1 hour ago"

Panel webowy#

Po uruchomieniu panel webowy jest dostępny pod adresem:

http://<IP>:8080

Przy pierwszym uruchomieniu zostaniesz przekierowany do kreatora konfiguracji (wizard).

Następne kroki#

Pierwsze uruchomienie - kreator konfiguracji krok po kroku