Instalacja na serwerze

Qubix działa na własnym serwerze — jedno polecenie instalacyjne uruchamia cały stack (baza danych, backend, serwer WWW, narzędzia pomocnicze). Wymagany jest jedynie czysty serwer Linux z dostępem SSH i Docker.

Wymagania serwera

Instalator sprawdza serwer przed uruchomieniem i odmawia kontynuacji na maszynie, która jest wyraźnie zbyt mała. Zalecane minimum:

Zasób	Zalecane minimum
CPU	4 vCPU
RAM	8 GB
Dysk	20 GB SSD lub HDD

Są to wartości zalecane przez instalator; poniżej nich system nadal działa, jednak wyświetla ostrzeżenie, że ClickHouse będzie wolny w dni o dużym ruchu. Twardym limitem jest 10 GB wolnego miejsca na dysku — poniżej tej wartości instalacja zostaje wstrzymana.

Typ dysku nie ma znaczenia dla obsługi ruchu — zarówno SSD, jak i HDD działają, a HDD pozwala zaoszczędzić; SSD przyspiesza jedynie raporty administracyjne przy dużych wolumenach. 20 GB w zupełności wystarcza na start: mieści platformę oraz tysiące kreacji, a historia ruchu praktycznie nic nie waży. Dokładne informacje o tym, ile ruchu i ile kreacji pomieści dany dysk, znajdziesz w Wyborze serwera.

Kilka twardych wymagań:

• 64-bitowy serwer Linux (VPS/VDS lub serwer dedykowany), nie komputer osobisty ani hosting współdzielony.
• Docker z wtyczką docker compose (V2). Stary, samodzielny docker-compose (V1) nie jest obsługiwany — instalator wykrywa go i zatrzymuje instalację.
• Wychodzące połączenia HTTPS, aby serwer mógł pobrać obrazy Qubix.

Czysty serwer

Qubix należy instalować na serwerze dedykowanym wyłącznie tej usłudze. Stack wymaga wolnych portów 80, 443 (oraz 8443 dla opcji Cloudflare). Jeśli inny serwer WWW zajmuje już te porty, należy je zwolnić lub wybrać opcję Cloudflare na późniejszym etapie kreatora.

Instalacja

1. Należy połączyć się z serwerem przez SSH jako root.

2. Uruchomić polecenie instalacyjne:

   Bash

   curl -sSL https://qubix.pro/install.sh | bash

   (lub wget -qO- https://qubix.pro/install.sh | bash)

   

3. Instalator wyświetla baner Qubix, sprawdza serwer, zadaje kilka pytań (folder instalacyjny, interfejs sieciowy do publikacji), następnie pobiera i uruchamia stos. Poczekaj, aż zgłosi, że wszystko działa.

Nie przerywać instalacji

Należy pozwolić instalatorowi zakończyć działanie. Zatrzymanie go w połowie może pozostawić stack w stanie częściowej konfiguracji — w takim przypadku najbezpieczniejszym rozwiązaniem jest usunięcie folderu instalacji i ponowne uruchomienie polecenia na czystym serwerze.

Co zostaje zainstalowane

Instalator uruchamia zestaw kontenerów tworzących Qubix: analityczną bazę danych, backend Qubix, serwer WWW oraz narzędzia do automatycznej aktualizacji, certyfikatów i AI. Kontenerami nie zarządza się ręcznie — Qubix zarządza nimi automatycznie.

Finalizacja konfiguracji w przeglądarce

Po uruchomieniu stacku instalator wyświetla link w postaci:

http://<adres-ip-serwera>:7000/install?k=…

Należy otworzyć ten pełny link w przeglądarce (klucz ?k=… jest wymagany). Otwiera on kreatora konfiguracji, w którym można wybrać sposób dostępu do Qubix, wprowadzić licencję i utworzyć pierwszego administratora.

Link działa jednorazowo

Kreator konfiguracji jest dostępny tylko do momentu jego ukończenia. Po utworzeniu pierwszego administratora link przestaje działać — jest to zachowanie oczekiwane. Od tej chwili logowanie odbywa się pod własnym adresem panelu.

Co dalej

Tworzenie administratora

Przejście przez kreatora konfiguracji: adres, licencja, administrator.

Przegląd interfejsu

Struktura i układ panelu administracyjnego.