# Pošta a notifikace (https://docs.vitrinka.ai/cs/operator/mail)



## Kdo ho smí měnit [#who]

Mailer posílá každý reset hesla a každý přihlašovací kód na instalaci, takže jde o nastavení pro celé nasazení. Platform admini ho mění přes kteroukoli organizaci, kterou spravují; při nastaveném `VITRINKA_OPS_ORG` ho přes tu organizaci mění i její admini. Bez nastavení ho drží jen platform admini — běžný admin organizace se nikdy nekvalifikuje, protože organizaci může vlastnit každý účet, který se zaregistruje ([první administrátor](/cs/operator/install#admin)).

Kdokoli jiný je odmítnut: `set` nebo `test` skončí kódem 2, aniž by cokoli změnily. Dokud `VITRINKA_OPS_ORG` není nastavené, a při nastaveném uvnitř té organizace, uvidí navíc proč a koho požádat — Nastavení ukáže místo formuláře důvod od serveru a `status` vypíše důvod i nápravu. Když nastavené je, admin jakékoli jiné organizace mailer vůbec neuvidí, stejně jako na hostované službě.

## V produktu [#settings]

**Settings → Organization → Email** nabízí stejná pole jako `set` — host, port, šifrování, uživatele, heslo, adresu odesílatele a volitelný balík privátní CA — a k tomu **send test email** a **remove saved settings**. Uložená konfigurace má přednost před prostředím `SMTP_*` / `RESEND_API_KEY` a platí od dalšího e-mailu.

## Nastavení relaye [#set]

```bash
vitrinka admin smtp set \
  --host smtp.example.com --port 587 --tls starttls \
  --from "vitrinka@example.com" --user mailer --password-stdin
```

| Přepínač           | Co dělá                                                                              |
| ------------------ | ------------------------------------------------------------------------------------ |
| `--host`           | Host relaye.                                                                         |
| `--port`           | Port relaye. Výchozí na serveru 587.                                                 |
| `--tls`            | `starttls`, `implicit` nebo `none`.                                                  |
| `--from`           | Adresa odesílatele.                                                                  |
| `--user`           | Uživatel relaye. Prázdná hodnota přepne na anonymní relay.                           |
| `--password-stdin` | Načte heslo relaye ze stdin.                                                         |
| `--password`       | Heslo jako argument — **raději `--password-stdin`**.                            |
| `--ca`             | Cesta k PEM balíku privátní CA.                                                      |
| `--no-ca`          | Zahodí uloženou CA a vrátí se k systémovým kořenům.                                  |
| `--clear`          | Smaže uloženou konfiguraci a spadne zpět na `SMTP_*` / `RESEND_API_KEY` z prostředí. |

<Callout type="warn">
  Používejte `--password-stdin`. Heslo předané jako `--password` vidí v `ps` kdokoli další na stroji.
</Callout>

## Ověření [#check]

`status` hlásí zdroj, host, režim TLS a adresu odesílatele a jestli je uložené heslo. `test` pošle testovací e-mail na vaši vlastní adresu.

```bash
vitrinka admin smtp status
vitrinka admin smtp test
```

Bez startu serveru — třeba před prvním spuštěním — pošle `vitrinka smtp-test` ze serverové binárky jeden testovací e-mail přes relay `SMTP_*` z vašeho `.env`:

```bash
docker compose run --rm --no-deps vitrinka smtp-test -to you@example.com
```

## Která organizace [#org]

Všechny tři podpříkazy jdou přes organizaci, kterou spravujete. `--org` vybere kterou, když jich váš login má víc; jinak se použije `$VITRINKA_ORG`, pak organizace navázaného workspace, pak vaše jediné členství. Platform admin smí použít kteroukoli organizaci, kterou spravuje, a admin organizace z `VITRINKA_OPS_ORG` jde přes tu — když váš login patří do několika, zadejte ji přes `--org`.

```bash
vitrinka admin smtp status --org acme
```

## Push notifikace [#push]

Web push dorazí na zařízení člověka i se zavřenou záložkou. Potřebuje pár klíčů VAPID — `VAPID_PUBLIC_KEY` a `VAPID_PRIVATE_KEY`, vygenerovaný jednou libovolnou knihovnou pro Web Push — a `VAPID_SUBSCRIBER`, kontakt `mailto:`, přes který vás push služby mohou zastihnout: nastavte vlastní adresu, protože výchozí hodnota je jen zástupná. Jakmile jsou klíče na místě, každý si push zapne pro každé zařízení zvlášť v **Settings → Preferences → Notifications** ([notifikace](/cs/use#notifications)).

`AIR_GAP=1` web push vymaže, protože posílá na push služby výrobců prohlížečů. E-mailové notifikace odcházejí přes mailer instalace výše a zůstávají vypnuté, dokud si je každý nezapne.