# Instalacja - wersja on-premise

# Instalacja OmniMES

Kompletna procedura wdrożenia systemu OmniMES - od pobrania Dockera, przez aktywację licencji, konfigurację Redash i serwera AI Ollama, po zmianę haseł, aktualizację i odinstalowanie.


---

## 1. Wymagania wstępne

Przed instalacją upewnij się, że na komputerze docelowym **wolne są następujące porty**:

| Port | Usługa |
|------|--------|
| 80   | Interfejs WWW (frontend) |
| 8091 | Backend API |
| 5000 | Redash (raporty) |
| 1883 | Broker MQTT (TCP) |
| 1884 | Broker MQTT (WebSocket) |
| 8083 | EMQX - panel administracyjny brokera |

Wymagany jest również **Docker**: <https://docs.docker.com/get-docker/>


:::info
Zalecanym środowiskiem dla serwera produkcyjnego jest **Linux (Debian / Ubuntu Server LTS) z Docker Engine**. Docker Desktop dla Windows nadaje się do testów i prezentacji — dlaczego nie zalecamy Windows Server, wyjaśnia rozdział *Wymagania sprzętowe* oraz sekcja 10.4.

:::


---

## 2. Instalacja krok po kroku


1. Pobierz i zainstaluj Docker odpowiedni dla swojego systemu.
2. Z paczki instalacyjnej uruchom skrypt zgodnie z systemem operacyjnym:
   * **Windows:** `install_all_windows.bat`
   * **Linux:** `install_all_linux.sh`

   Skrypty te instalują **pełną wersję OmniMES** wraz z komponentami: API, Stream, WWW, Redash oraz Ollama.
3. **Linux - nadanie uprawnień** (przed pierwszym uruchomieniem):

   ```bash
   chmod +x install_linux.sh uninstall.sh updated_api.sh updated_www.sh
   ./install_all_linux.sh
   ```
4. **Windows - komunikat „System Windows ochronił ten komputer"** Kliknij **Więcej informacji** → **Uruchom mimo to**.


---

## 3. Pierwsze logowanie

### 3.1. Otwarcie aplikacji w przeglądarce

Po zakończeniu pracy skryptu otwórz przeglądarkę i wpisz w **pasku adresu** jeden z adresów:

* `localhost`
* `127.0.0.1`
* lokalny adres IP komputera, na którym zainstalowano oprogramowanie

Pojawi się ekran logowania OmniMES.

### 3.2. Wypełnienie ekranu logowania

Na formularzu logowania znajdują się **trzy pola** - uzupełnij je w następujący sposób:

| Pole | Co wpisać | Uwagi |
|------|-----------|-------|
| **API URL** | adres backendu OmniMES, np. `http://localhost:8091` | To **nie jest** adres przeglądarki - to adres usługi API, która zawsze działa na porcie **8091**. Jeśli OmniMES uruchomiony jest na innym komputerze, zamień `localhost` na jego IP, np. `http://192.168.3.100:8091`. |
| **Nazwa użytkownika** | `omni`    | Domyślne konto utworzone po instalacji - **superuser** z dostępem do wszystkich funkcji, niezależnie od uprawnień grup. |
| **Hasło** | `#omni2026` | Domyślne hasło fabryczne. |

> ℹ️ **Częsty błąd:** w polu **API URL** wpisuje się adres usługi backendu (port `8091`), **nie** adres, z którego otwierasz przeglądarkę (port `80`). Te adresy zwykle różnią się portem i mogą wskazywać różne hosty (np. frontend lokalnie, API na serwerze).

> ⚠️ **Bezpieczeństwo:** Hasło fabryczne należy zmienić **natychmiast po pierwszym zalogowaniu**.


---

## 4. Aktywacja licencji

Po zalogowaniu system automatycznie przeniesie Cię do ekranu aktywacji. Wprowadź **klucz licencji** dostarczony wraz z paczką - produkt jest gotowy do użytku.


---

## 5. Konfiguracja Redash (raporty)

Redash to wbudowany silnik raportowy OmniMES, dostępny lokalnie pod adresem:

```
http://localhost:5000/
```

> ℹ️ Po instalacji **baza Redash jest odtwarzana automatycznie** - wraz z gotowym źródłem danych, zapytaniami i pulpitami. **Nie trzeba ręcznie dodawać źródła danych JSON ani konfigurować połączenia.** Wystarczą poniższe trzy kroki.

### 5.1. Zaloguj się do Redash

Otwórz `http://localhost:5000/` i zaloguj się danymi domyślnymi:

| Pole | Wartość domyślna |
|------|------------------|
| **Email** | `omni@omnimes.com` |
| **Hasło** | `#omni2026`      |

### 5.2. Zmień domyślny login i hasło

Ze względów bezpieczeństwa **natychmiast zmień domyślny email i hasło** na własne: w Redash kliknij **Settings** (lewy dolny róg) → **Account** i ustaw nowe dane logowania.

### 5.3. Wygeneruj token i wklej go do OmniMES


1. W Redash przejdź do **Settings → Account**.
2. W sekcji **API Key** kliknij **Regenerate**, aby wygenerować **nowy token**, i skopiuj go.
3. W OmniMES przejdź do **Ustawienia systemowe → Konfiguracja ogólna**, zakładka **Redash**, i uzupełnij:
   * **Adres Redash:** `localhost:5000`
   * **Token Redash:** wklejony, świeżo wygenerowany token

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi85OWQwMjM3NS1hOTdlLTQ3OTgtYTdjMi05YTU0Yjk1NTU5NDUvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.q9xXjVsPAysNnTJrSOZJ4OITiP7G2m0_oPmGIycIJbA " =612.5x435.5")

Od tej chwili OmniMES jest połączony z Redash - możesz korzystać z gotowych raportów i pulpitów.


---

## 6. Konfiguracja Ollama (asystent AI)

Serwer **Ollama** dostarcza lokalne modele językowe dla wbudowanego asystenta AI w OmniMES. Jest **automatycznie instalowany** wraz z pełną wersją systemu (skrypty `install_all_*`).

### 6.1. Wymagania sprzętowe

Domyślna instalacja wykorzystuje **CPU**, więc wydajność zależy od mocy procesora:

* **CPU (minimum):** procesor stacjonarny **24-rdzeniowy** lub silniejszy.
* **GPU (zalecane):** karta NVIDIA serii **3070** lub wyższa (jedna lub więcej, zależnie od wybranego modelu AI).

> 💡 **Rekomendacja:** Dla większych wdrożeń uruchom Ollama **na osobnym serwerze** (Docker lub natywnie).

### 6.2. Instalacja na osobnym serwerze

* Obraz Docker: <https://hub.docker.com/r/ollama/ollama>
* Linux: <https://github.com/ollama/ollama/blob/main/docs/linux.md>
* Windows: <https://github.com/ollama/ollama/blob/main/docs/windows.md>

#### docker-compose.yaml

```yaml
version: '3.8'

services:
  ollama:
    image: ollama/ollama
    environment:
      - OLLAMA_ORIGINS="*"
      - OLLAMA_HOST="0.0.0.0:11434"
    container_name: ollama
    ports:
      - "11434:11434"
    volumes:
      - ollama:/root/.ollama
    restart: unless-stopped

volumes:
  ollama:
```

Dla dostępu z zewnątrz: `host = 0.0.0.0`, `port = 11434`, `CORS = "*"` (lub zawężony do potrzeb).

### 6.3. Pobranie modelu AI

Lista wspieranych modeli: <https://ollama.com/library>

Pobranie wybranego modelu:

```bash
ollama pull llama3
```

### 6.4. Powiązanie z OmniMES

W **Ustawieniach** OmniMES:


1. Wybierz typ AI: **wewnętrzna**.
2. Wprowadź adres serwera Ollama (np. `http://192.168.3.100:11434`).
3. W polu **Wersja modelu AI** powinna pojawić się lista pobranych modeli.

Jeśli połączenie się nie powiedzie, w polu pojawi się komunikat błędu - sprawdź adres serwera i otwarte porty.


---

## 7. Zmiana haseł systemowych

Hasło do **bazy PostgreSQL** lub **brokera MQTT** zmienia się dołączonym skryptem `**set_pass.py**`. Skrypt operuje na uruchomionych kontenerach (`docker compose exec database psql`), dlatego **stack OmniMES musi być włączony**, a sam skrypt wymaga jedynie zainstalowanego **Pythona** i działającego Dockera - **bez dodatkowych bibliotek** (nie trzeba podawać hosta, portu ani starego hasła). Uruchamiaj go w katalogu, w którym znajduje się `docker-compose.yaml` stacku OmniMES.

### 7.1. Zmiana hasła brokera MQTT (użytkownik `emqx`)

```bash
# Windows
py set_pass.py --newpassbroker NOWE_HASLO_BROKERA
# Linux / macOS
python3 set_pass.py --newpassbroker NOWE_HASLO_BROKERA
```

Skrypt aktualizuje hasło użytkownika MQTT `emqx` w bazie, plik `.env` streama i restartuje usługę `stream`.

### 7.2. Zmiana hasła bazy PostgreSQL (użytkownik `omni`)

```bash
# Windows
py set_pass.py --newpassdb NOWE_HASLO_BAZY
# Linux / macOS
python3 set_pass.py --newpassdb NOWE_HASLO_BAZY
```

Skrypt zmienia hasło użytkownika `omni`, aktualizuje `omnimes/.env`, konfigurację autoryzacji EMQX (`emqx_auth_pgsql.conf`), `config.json` API oraz `.env` streama, a następnie restartuje usługi `broker`, `api` i `stream` - **nie trzeba nic robić ręcznie**.


---

## 8. Aktualizacja systemu

Każdy główny komponent można aktualizować **niezależnie** za pomocą dedykowanych skryptów:

| Komponent | Windows | Linux |
|-----------|---------|-------|
| API       | `updated_api.bat` | `updated_api.sh` |
| Stream (MQTT / Sparkplug B) | `updated_stream.bat` | `updated_stream.sh` |
| Frontend WWW | `updated_www.bat` | `updated_www.sh` |

Każdy ze skryptów wykonuje sekwencję: **pull → rebuild → restart kontenera**.


:::info
**Aktualizacja do wersji 4.8.0 - kontrola uprawnień.** Od wersji 4.8.0 serwer sprawdza uprawnienia grup z zakładki **Administracja → Uprawnienia dostępu** (zmienna `OMNIMES_RBAC_MODE`, sekcja 12.1). Zaktualizowana instalacja zachowuje tryb z pliku `omnimes/.env`, a bez tego wpisu działa w trybie `audit` - niczego nie blokuje, tylko zapisuje operacje, które zostałyby zablokowane. Aby włączyć blokowanie:


1. Przejrzyj raport poleceniem `docker compose exec api python manage.pyc rbac --odmowy` (w katalogu `omnimes`) i uzupełnij grupom brakujące ekrany w **Uprawnieniach dostępu**.
2. Dopisz w `omnimes/.env` wiersz `OMNIMES_RBAC_MODE=enforce`. Jeśli w pliku `docker-compose.yaml`, w sekcji `environment` usługi `api`, nie ma wiersza `OMNIMES_RBAC_MODE: ${OMNIMES_RBAC_MODE:-}`, dopisz go.
3. Uruchom `docker compose up -d --no-deps api` (w katalogu `omnimes`). Flaga `--no-deps` sprawia, że ponownie uruchamiany jest tylko kontener API, bez bazy danych.

Powrót do poprzedniego działania: `OMNIMES_RBAC_MODE=audit` (albo `off`) i ponownie `docker compose up -d --no-deps api`. Szczegóły: plik `BEZPIECZENSTWO_API.md` w paczce instalacyjnej.

:::

> 💡 **Linux:** pamiętaj o uprawnieniach - `chmod +x updated_*.sh` przed pierwszym uruchomieniem.

### 8.1. Pełna odbudowa środowiska

W razie problemów (uszkodzony kontener, niespójność konfiguracji) można wymusić odbudowę:

* **OmniMES:** `recreated_omnimes.bat` (Windows)
* **Redash:** `recreated_redash.bat` (Windows)

> ⚠️ Odbudowa **nie usuwa wolumenu** `postgres_data` z danymi bazy, ale przed uruchomieniem rekomendowany jest backup.


---

## 9. Odinstalowanie

### 9.1. Procedura

W folderze instalacyjnym uruchom skrypt:

* **Windows:** `uninstall.bat`
* **Linux / macOS:** `uninstall.sh`

W systemie Linux pamiętaj wcześniej o nadaniu uprawnień:

```bash
chmod +x uninstall.sh
./uninstall.sh
```

### 9.2. Ostrzeżenie - utrata danych

> ⚠️ Odinstalowanie usuwa **wszystkie kontenery, włącznie z kontenerem bazy** `**database**` (PostgreSQL + TimescaleDB), w którym przechowywane są dane z urządzeń produkcyjnych.
>
> **Przed odinstalowaniem wykonaj backup bazy danych** - przez **Adminer** (`http://localhost:8079`) lub poleceniem `docker compose exec database pg_dump -U omni -Fc -d data > data.dump` (analogicznie dla bazy `omni`). Odtworzenie: `pg_restore`.


---

## 10. Udostępnianie OmniMES poza komputerem

### 10.1. Co zrobić, gdy port 80 jest zajęty?

Domyślnie interfejs WWW OmniMES działa na porcie 80. Jeśli port jest zajęty:

* **Opcja A:** zwolnij port 80 w systemie operacyjnym (zatrzymaj usługę, która z niego korzysta).
* **Opcja B:** zmień mapowanie portu w `docker-compose.yaml` - w sekcji `www` zmień **lewą** liczbę z `80:80` na np. `8080:80`. Po tym OmniMES będzie dostępny pod `http://<adres>:8080`.

### 10.2. Udostępnienie poza siecią lokalną

Konfigurację należy wykonać **na routerze**, kierując ruch na adres IP komputera, na którym zainstalowano system. Wymagane przekierowania portów (port forwarding):

| Port(y) | Usługa |
|---------|--------|
| 80, 443 | Serwer WWW |
| 1883, 1884 | MQTT - urządzenia zewnętrzne wysyłające dane do brokera |
| 8083    | WebSocket Secure (WSS) - strumień danych do podglądu w monitoringu |

### 10.3. Podłączenie urządzenia zewnętrznego (HMI / bramka)

W urządzeniu (panel HMI, bramka komunikacyjna itp.) wskaż:

* **Adres serwera** OmniMES, np. `192.168.3.100`
* **Port MQTT:** `1883` (standardowy)
* **Dane logowania do brokera EMQX:**
  * Login: `emqx`
  * Hasło: `Fb7jCkux` *(fabryczne - zmień po wdrożeniu, patrz sekcja 7)*

### 10.4. Windows jako serwer (niezalecane) - automatyczny start Dockera


:::warning
Zalecamy uruchamianie OmniMES na **serwerze z Linuksem i Docker Engine** (patrz rozdział *Wymagania sprzętowe*). Na Windows Server Docker Desktop nie jest wspierany przez producenta, a kontenery linuksowe działają w dodatkowej maszynie wirtualnej. Instalacja na Windows Server wymaga indywidualnych ustaleń z zespołem OmniMES.

:::

Jeśli system musi działać na Windows, włącz w Docker Desktop opcję **„Start Docker Desktop when you log in"**. Pamiętaj, że Docker Desktop działa w sesji zalogowanego użytkownika — po restarcie (np. po aktualizacjach Windows) OmniMES wystartuje dopiero, gdy ktoś się zaloguje.


---

## 11. Pliki instalacyjne - referencja

### 11.1. Pełna instalacja

| Plik | Opis |
|------|------|
| `install_all_linux.sh` | Pełny system OmniMES na Linux (API + Stream + WWW + Redash + Ollama) |
| `install_all_windows.bat` | Pełny system OmniMES na Windows (API + Stream + WWW + Redash + Ollama) |
| `install_all_without_ollama.bat` | Pełna instalacja **bez Ollama** - Windows (szybsza, bez modeli LLM) |
| `install_all_without_ollama.sh` | Pełna instalacja **bez Ollama** - Linux |

### 11.2. Instalacja modułowa

| Plik | Opis |
|------|------|
| `install_omnimes.bat` | Tylko podstawa OmniMES (API + Stream + WWW) - Windows |
| `install_omnimes_linux_mac.sh` | Tylko podstawa OmniMES - Linux / macOS |
| `install_ollama.bat` | Tylko serwer Ollama - Windows |
| `install_ollama.sh` | Tylko serwer Ollama - Linux |

### 11.3. Aktualizacje pojedynczych komponentów

| Plik | Opis |
|------|------|
| `updated_api.bat` / `updated_api.sh` | Aktualizacja kontenera API (pull → rebuild → restart) |
| `updated_stream.bat` / `updated_stream.sh` | Aktualizacja modułu Stream (MQTT / Sparkplug B) |
| `updated_www.bat` / `updated_www.sh` | Aktualizacja frontendu WWW |

### 11.4. Odbudowa środowiska

| Plik | Opis |
|------|------|
| `recreated_omnimes.bat` | Rebuild OmniMES - usuwa kontenery i tworzy je od nowa (Windows) |
| `recreated_redash.bat` | Rebuild środowiska Redash |

### 11.5. Odinstalowanie

| Plik | Opis |
|------|------|
| `uninstall_all.bat` / `uninstall_all.sh` | Pełne usunięcie OmniMES (wraz z danymi!) |
| `uninstall_omnimes.bat` / `uninstall_omnimes.sh` | Usuwa tylko bazową instalację OmniMES (bez Redash, bez Ollama) |
| `uninstall_ollama.bat` / `uninstall_ollama.sh` | Usuwa wyłącznie Ollama |

### 11.6. Narzędzia

| Plik | Opis |
|------|------|
| `set_pass.py` | Skrypt Python - zmienia hasło bazy PostgreSQL (`omni`) i brokera MQTT (`emqx`). Wymaga tylko Pythona i działającego Dockera (stack musi być uruchomiony). |


---

## 12. Pliki konfiguracyjne `.env`

W paczce instalacyjnej są **dwa pliki** `**.env**`, które konfigurują system. Ustaw je **przed pierwszym uruchomieniem** skryptu instalacyjnego.

### 12.1. `omnimes/.env` - stack OmniMES

| Zmienna | Znaczenie |
|---------|-----------|
| `POSTGRES_USER` | superużytkownik bazy (domyślnie `omni`) |
| `POSTGRES_PASSWORD` | hasło superużytkownika bazy (zmień na produkcji) |
| `POSTGRES_HOST` | host bazy widziany z kontenerów - `database` (nazwa serwisu) |
| `POSTGRES_PORT` | port bazy - `5432` |
| `OMNIMES_API_HOST` | **publiczny** adres API widziany z przeglądarki, np. `http://192.168.1.100:8091` lub `https://api.domena.pl` |
| `OMNIMES_WWW_PORT` | port frontendu WWW (domyślnie `80`) |
| `OMNIMES_RBAC_MODE` | kontrola uprawnień w API: `enforce` (blokuje operacje bez uprawnień - w nowych instalacjach od wersji 4.8.0), `audit` (nic nie blokuje, zapisuje operacje, które zostałyby zablokowane - domyślnie, gdy zmiennej brak), `off` (wyłączona). Opis: rozdział *Administracja → Uprawnienia dostępu* |

### 12.2. `redash/.env` - stack Redash

| Zmienna | Znaczenie |
|---------|-----------|
| `REDASH_COOKIE_SECRET`, `REDASH_SECRET_KEY`, `COOKIE_SECRET`, `SECRET_KEY` | sekrety sesji/szyfrowania - **zmień na produkcji** |
| `REDIS_URL` | połączenie do Redis (`redis://redis:6379/0`) |
| `REDASH_DATABASE_URL` | połączenie do bazy `redash` w kontenerze `database` (`postgresql://omni:HASLO@database:5432/redash`) |
| `REDASH_HOST` | (opcjonalne) publiczny adres Redasha - z niego budowane są linki do publicznych pulpitów |
| `REDASH_MAIL_*` | (opcjonalne) konfiguracja serwera poczty SMTP - patrz uwaga niżej |

> ✉️ **Poczta SMTP w Redash - ustaw PRZED instalacją (jeśli potrzebna).** Pola `REDASH_MAIL_SERVER` / `REDASH_MAIL_PORT` / `REDASH_MAIL_USE_TLS` / `REDASH_MAIL_USE_SSL` / `REDASH_MAIL_USERNAME` / `REDASH_MAIL_PASSWORD` / `REDASH_MAIL_DEFAULT_SENDER` są potrzebne **tylko** do **powiadomień e-mail o alertach**, zaproszeń użytkowników i resetu hasła. Redash działa bez nich.
>
> * Jeśli chcesz e-maile → uzupełnij te pola **własnym serwerem SMTP przed instalacją**.
> * Jeśli **nie** używasz poczty → te linie **muszą pozostać zakomentowane**. **Nigdy nie zostawiaj pustej linii** typu `REDASH_MAIL_PORT=` - Redash wykonuje `int('')` i kontener wpada w **pętlę restartów**.
> * Po edycji `.env` **odtwórz kontener** (`docker compose up -d`), a nie tylko `restart` - Docker Compose wczytuje `.env` przy **tworzeniu** kontenera, nie przy restarcie.


---

## 13. Przeniesienie danych na inny serwer (dumpy bazy)

System można przenieść **z danymi** na inny serwer. Na starym serwerze zrób dumpy z kontenera `database`, skopiuj je do `omnimes/database/base/` **przed buildem**, a skrypt instalacyjny odtworzy całość na nowym serwerze.

```bash
docker compose exec database pg_dump -U omni -Fc -d omni        > omni.dump        # konfiguracja
docker compose exec database pg_dump -U omni -Fc -d omni_queue  > omni_queue.dump  # kolejka Django Q
docker compose exec database pg_dump -U omni -Fc -d mqtt        > mqtt.dump        # auth EMQX
docker compose exec database pg_dump -U omni -Fc -d redash      > redash.dump      # dashboardy/queries/users
docker compose exec database pg_dump -U omni -Fc -d data        > data.dump        # telemetria (hypertable Timescale)
```

Skopiuj wybrane pliki do `instalka3/omnimes/database/base/` i uruchom instalację.

| Plik (opcjonalny) | Co odtwarza |
|-------------------|-------------|
| `omni.dump`       | konfiguracja - w praktyce jedyny potrzebny (admin + menu do logowania) |
| `omni_queue.dump`, `mqtt.dump`, `redash.dump` | kolejka / auth brokera / Redash (transplant) |
| `data.dump`       | telemetria - **musi** być formatem `pg_dump -Fc` (hypertable Timescale; Adminer/SQL jej nie odtworzy) |

> ℹ️ Bez dumpów = świeża instalacja: schemat tworzy `migrate`, a bazę `data` zasila `stream`. Szczegóły i akceptowane formaty (`.dump` / `.sql` / `.sql.gz`) opisuje plik `database/base/README.md`.


---

# Sekcja B - Wpisy w FAQ (3 krótkie skróty)

> **Gdzie wkleić:** sekcja `FAQ` w Outline. Każdy wpis poniżej to osobna podstrona - krótka treść + link do kotwicy na stronie `Instalacja`.
>
> **Uwaga o linkach:** Outline tworzy kotwice automatycznie z nagłówków, w formie `#numer-tytul-z-myslnikami`. Po opublikowaniu strony *Instalacja* sprawdź dokładny URL kotwicy (klikając „kopiuj link" przy nagłówku w Outline) i podstaw go pod `[link …]` poniżej.

## B.1 - „Jak zmienić hasło do bazy PostgreSQL lub brokera MQTT?"

```markdown
# Jak zmienić hasło do bazy PostgreSQL lub brokera MQTT?

Zmiana haseł systemowych odbywa się dołączonym skryptem
**`set_pass.py`** (wymaga tylko Pythona i działającego Dockera; stack OmniMES musi być uruchomiony).

➡ Pełna instrukcja, wraz z konkretnymi poleceniami CLI dla brokera i
bazy PostgreSQL, znajduje się w sekcji
**[Zmiana haseł systemowych](/doc/instalacja#7-zmiana-hasel-systemowych)**.
```

## B.2 - „Port 80 jest zajęty - co zrobić?"

```markdown
# Port 80 jest zajęty - jak uruchomić OmniMES?

OmniMES domyślnie nasłuchuje na porcie 80. Jeśli port jest zajęty przez
inną usługę, masz dwie możliwości:

- zwolnij port 80 w systemie,
- albo zmień lewą stronę mapowania portu w `docker-compose.yaml` w sekcji
  `www` z `80:80` na np. `8080:80`.

➡ Szczegóły wraz z opisem przekierowań na routerze i podłączania urządzeń
HMI znajdziesz w sekcji
**[Udostępnianie OmniMES poza komputerem](/doc/instalacja#10-udostepnianie-omnimes-poza-komputerem)**.
```

## B.3 - „Jak odinstalować OmniMES?"

```markdown
# Jak odinstalować OmniMES?

W folderze instalacyjnym uruchom skrypt:

- **Windows:** `uninstall.bat`
- **Linux / macOS:** `uninstall.sh` (najpierw `chmod +x uninstall.sh`)

> ⚠️ Procedura usuwa **wszystkie kontenery, w tym bazę `database`** (PostgreSQL)
> z danymi produkcyjnymi. Przed odinstalowaniem zrób backup przez Adminer lub `pg_dump`.

➡ Pełna procedura wraz z opisem przywracania danych znajduje się w sekcji
**[Odinstalowanie](/doc/instalacja#9-odinstalowanie)**.
```


---

#

---

**Documents**

- [Omnimes](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnimes-k1PbFf5XE7)
- [Omnienergy](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnienergy-BWrsbBiH1j)
- [Omniplatform](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omniplatform-jARFxkuLdt)
- [FAQ](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/faq-XN4QKuFPZL)
- [Cyberbezpieczeństwo i zgodność (CRA)](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/cyberbezpieczenstwo-i-zgodnosc-cra-6dbPWZS59e)