# Pomoc Hostava — pełna treść

Źródło: https://pomoc.hostava.pl/

# Pierwsze kroki

## Jak założyć konto w Hostava

Adres: https://pomoc.hostava.pl/pierwsze-kroki/zalozenie-konta

Rejestracja konta, pierwsze logowanie, odzyskiwanie hasła i to, co warto zrobić zaraz po założeniu konta.

Konto w Hostava zakładasz samodzielnie, w minutę. Jedno konto daje dostęp do wszystkich usług: hostingu stron i poczty, domen, serwerów VPS, baz danych, aplikacji, Kubernetes i VPN.

#### Rejestracja krok po kroku

1. Otwórz stronę rejestracji: `https://cloud.hostava.pl/register`.
2. Wpisz **Imię i nazwisko** (możesz też podać nazwę firmy).
3. Podaj adres **E-mail** — na niego będą przychodzić faktury, powiadomienia i linki do resetu hasła.
4. Ustaw **Hasło** — co najmniej 8 znaków. Zalecamy dłuższe hasło z menedżera haseł.
5. Zaznacz akceptację Regulaminu (w tym warunków SLA i rozliczeń) oraz Polityki prywatności.
6. Kliknij **Utwórz konto**.

Po rejestracji od razu jesteś zalogowany i trafiasz do panelu. Na koncie automatycznie tworzymy pierwszy projekt o nazwie **Mój projekt** — do niego trafią Twoje pierwsze serwery. Więcej o projektach przeczytasz w artykule [Czym są projekty](../projekty-i-sieci/czym-sa-projekty).

> **Wskazówka:** Masz już zaproszenie do zespołu innej firmy? Kliknij link z e-maila z zaproszeniem — jeśli nie masz konta, założysz je na tej samej stronie i od razu dołączysz do zespołu. Szczegóły w artykule [Zespół i role](../konto-i-rozliczenia/zespol-i-role).

#### Logowanie

1. Wejdź na `https://cloud.hostava.pl/login`.
2. Podaj e-mail i hasło, kliknij **Zaloguj**.
3. Jeśli masz włączoną weryfikację dwuetapową, panel poprosi jeszcze o **Kod uwierzytelniania (2FA)** — 6-cyfrowy kod z aplikacji albo jeden z kodów zapasowych.

Sesja w przeglądarce jest ważna do 14 dni. Wylogujesz się z menu z Twoimi inicjałami w prawym górnym rogu → **Wyloguj**.

> **Uwaga:** Po 10 nieudanych próbach logowania na ten sam adres e-mail logowanie jest czasowo blokowane (na kilkanaście minut). Komunikat na stronie logowania podaje, za ile minut możesz spróbować ponownie.

#### Nie pamiętasz hasła

1. Na stronie logowania kliknij **Nie pamiętasz hasła?**.
2. Podaj adres e-mail konta i kliknij **Wyślij link**.
3. Otwórz wiadomość i kliknij link. Link jest ważny **1 godzinę** i działa tylko raz.
4. Ustaw nowe hasło (min. 8 znaków), powtórz je i kliknij **Ustaw hasło**.

Po zmianie hasła wylogowujemy wszystkie sesje na wszystkich urządzeniach. Weryfikacja dwuetapowa nadal obowiązuje — przy logowaniu podasz kod z aplikacji.

> **Wskazówka:** Nie widzisz wiadomości? Sprawdź folder ze spamem. Ze względów bezpieczeństwa strona zawsze pokazuje ten sam komunikat — także wtedy, gdy na podany adres nie ma konta.

#### Co zrobić zaraz po założeniu konta

| Krok | Gdzie w panelu | Po co |
|---|---|---|
| Włącz weryfikację dwuetapową | Menu z inicjałami → **Mój profil** | Chroni konto nawet przy wycieku hasła |
| Uzupełnij dane do faktury | **Konto → Rozliczenia** | Faktura za doładowanie wystawi się na Twoją firmę |
| Doładuj konto | **Konto → Rozliczenia** | Usługi są opłacane z salda (prepaid) |
| Dodaj klucz SSH | **Dla programistów → Klucze SSH** | Jeśli planujesz serwery VPS |

Powiązane artykuły:

- [Panel klienta — co gdzie znajdziesz](../pierwsze-kroki/panel-klienta-przeglad)
- [Hosting, VPS czy chmura — od czego zacząć](../pierwsze-kroki/pierwszy-serwer-lub-strona)
- [Weryfikacja dwuetapowa (2FA)](../konto-i-rozliczenia/weryfikacja-dwuetapowa)
- [Doładowanie konta](../konto-i-rozliczenia/doladowanie-konta)

## Panel klienta — co gdzie znajdziesz

Adres: https://pomoc.hostava.pl/pierwsze-kroki/panel-klienta-przeglad

Przewodnik po menu panelu Hostava — sekcje, przycisk Utwórz, saldo, przełączanie kont i ustawienia profilu.

Panel klienta (`https://cloud.hostava.pl`) składa się z trzech części: **menu po lewej stronie**, **górnego paska** i **obszaru roboczego**. Na telefonie menu otwierasz ikoną z trzema kreskami w lewym górnym rogu.

#### Górny pasek

- **Saldo** — aktualny stan konta prepaid (kwota netto). Kliknięcie przenosi do Rozliczeń. Czerwony kolor oznacza, że środki zaraz się skończą, a masz usługi rozliczane godzinowo.
- **Utwórz** — szybkie tworzenie: Serwer VPS, Baza danych, Load balancer, Klaster Kubernetes, RabbitMQ, Hosting, Aplikacja, Projekt i Klucz SSH.
- **Menu z inicjałami** — **Mój profil** (ustawienia konta) i **Wyloguj**.

#### Menu po lewej

**Przegląd** — strona startowa: saldo, koszt w tym miesiącu i prognoza, liczba serwerów i projektów, ostatnie serwery. Tu zobaczysz też ostrzeżenie, gdy serwery zostały zawieszone z powodu braku środków.

**Projekty** — lista Twoich projektów z liczbą serwerów. Kolorowy znacznik pokazuje środowisko (Produkcja, Staging, Development). Ikoną **+** dodasz nowy projekt.

**Strony i poczta** — wszystko dla hostingu współdzielonego:

| Pozycja | Co tam jest |
|---|---|
| Podsumowanie | Twoje pakiety hostingu i zamawianie nowego |
| Domeny | Rejestracja, transfer i strefy DNS domen |
| Strony | Strony WWW, a pod spodem: Bazy danych, FTP, Cron |
| Poczta | Domeny pocztowe, skrzynki i aliasy |
| Monitoring | Sprawdzanie dostępności stron |

**Serwery i chmura** — Serwery (VPS), Aplikacje, Kubernetes, Load balancery, VPN.

**Dane** — Bazy danych (zarządzane), Storage S3, RabbitMQ, Logi (serwer logów).

**Dla programistów** — Klucze SSH, Tokeny API, Dokumentacja API.

**Konto**:

- **Rozliczenia** — saldo, doładowanie, automatyczne doładowanie kartą, historia transakcji, płatności i faktury.
- **Wsparcie** — zgłoszenia do naszego zespołu.
- **Aktywność** — historia działań na koncie (z panelu, API i systemu).
- **Bezpieczeństwo** — lista kontrolna zabezpieczeń konta i usług oraz dokument z opisem zabezpieczeń do oceny dostawcy.

#### Mój profil (ustawienia konta)

Otwierasz go z menu z inicjałami. Znajdziesz tu:

- dane profilu i linki do Regulaminu, SLA i Polityki prywatności,
- **Zmiana hasła**,
- **Powiadomienia** (e-maile o problemach z usługami i o logowaniu),
- **Uwierzytelnianie dwuskładnikowe (2FA)**,
- **Aktywne sesje**,
- **Konto zespołu** — zapraszanie współpracowników.

#### Przełączanie kont

Jeśli ktoś zaprosił Cię do swojego zespołu, w menu nad sekcją **Projekty** pojawi się przełącznik kont. Wybierz konto, a panel odświeży się i pokaże zasoby tego konta. Pod adresem e-mail widzisz swoją rolę: **Twoje konto**, **Administrator** albo **Podgląd**.

> **Wskazówka:** Jeśli nie widzisz w menu pozycji **Rozliczenia** ani salda, prawdopodobnie pracujesz na koncie zespołu, którego właściciel ukrył przed Tobą kwoty. Przełącz się na swoje konto, aby zobaczyć własne rozliczenia.

Powiązane artykuły:

- [Hosting, VPS czy chmura — od czego zacząć](../pierwsze-kroki/pierwszy-serwer-lub-strona)
- [Zespół i role](../konto-i-rozliczenia/zespol-i-role)
- [Bezpieczeństwo konta](../konto-i-rozliczenia/bezpieczenstwo-konta)

## Hosting, VPS czy chmura — od czego zacząć

Adres: https://pomoc.hostava.pl/pierwsze-kroki/pierwszy-serwer-lub-strona

Krótki przewodnik, która usługa pasuje do Twojego projektu — hosting stron i poczty, serwer VPS czy usługi chmurowe.

W Hostava masz w jednym panelu zarówno prosty hosting stron, jak i pełną chmurę. Poniżej znajdziesz najkrótszą drogę do wyboru.

#### Szybka ściągawka

| Potrzebujesz… | Wybierz | Jak płacisz |
|---|---|---|
| Strony firmowej, bloga, sklepu na WordPressie, poczty w domenie | **Hosting** (Strony i poczta) | Z góry: miesięcznie albo rocznie |
| Własnego systemu z dostępem root, dowolnego oprogramowania | **Serwer VPS** | Za każdą rozpoczętą godzinę, z limitem miesięcznym |
| Aplikacji w kontenerach z kilkoma replikami | **Aplikacja** | Godzinowo |
| Bazy danych bez administrowania serwerem | **Baza danych** | Godzinowo |
| Klastra kontenerów | **Kubernetes** | Godzinowo |

#### Hosting — gdy chcesz po prostu mieć stronę i pocztę

Hosting współdzielony to gotowe środowisko: nie instalujesz systemu ani nie aktualizujesz serwera. W pakiecie masz:

- strony z darmowym certyfikatem SSL i WordPressem instalowanym jednym kliknięciem,
- pocztę w swojej domenie (skrzynki, aliasy, przekierowania, autoresponder),
- bazy danych MySQL, dostęp FTP i wybór wersji PHP,
- kopie zapasowe co godzinę — stronę przywrócisz sam z panelu.

Jak zamówić:

1. W menu wybierz **Strony i poczta → Podsumowanie** (albo **Utwórz → Hosting**).
2. Kliknij **Zamów hosting**, wybierz pakiet i okres (**Rocznie** lub **Miesięcznie**).
3. Wpisz nazwę (np. swoją domenę) i kliknij **Zamów i zapłać**. Kwotę pobieramy z salda z góry.

> **Uwaga:** Hosting współdzielony nie jest przeznaczony dla systemów objętych NIS2. W takim przypadku wybierz serwer VPS, zarządzaną bazę danych i serwer logów.

#### Serwer VPS — gdy potrzebujesz pełnej kontroli

VPS to Twoja własna maszyna wirtualna z dostępem root. Instalujesz na niej, co chcesz: system z listy obrazów albo gotową aplikację. Serwer jest gotowy zwykle w niecałą minutę.

1. Kliknij **Utwórz → Serwer VPS**.
2. Wybierz lokalizację, system, plan i sposób logowania (klucz SSH albo hasło).
3. Wybierz projekt i kliknij przycisk tworzenia.

Szczegółowy opis kreatora znajdziesz w artykule [Jak utworzyć serwer VPS](../serwery/tworzenie-serwera).

> **Wskazówka:** Do utworzenia serwera potrzebujesz salda wystarczającego co najmniej na jedną godzinę jego pracy. Płacisz tylko za czas, gdy serwer istnieje, a w miesiącu nigdy więcej niż cena miesięczna planu.

#### Chmura — gdy rośniesz

Gdy jeden serwer to za mało, sięgnij po usługi zarządzane:

- **Aplikacje** — Twoje kontenery Docker Compose uruchomione w kilku replikach za load balancerem ([więcej](../aplikacje/aplikacje-docker-compose)).
- **Bazy danych** — PostgreSQL, MySQL, MariaDB i Redis z kopiami zapasowymi ([więcej](../bazy-danych/zarzadzane-bazy-danych)).
- **Kubernetes**, **Load balancery**, **RabbitMQ**, **Storage S3** i **VPN**.

Wszystkie zasoby chmurowe trafiają do projektu i łączą się przez jego [sieć prywatną](../projekty-i-sieci/siec-prywatna-projektu) — np. aplikacja łączy się z bazą bez wystawiania jej do Internetu.

#### Zanim zaczniesz

1. [Doładuj konto](../konto-i-rozliczenia/doladowanie-konta) — wszystkie usługi są opłacane z salda.
2. Przeczytaj, [jak liczymy koszty](../konto-i-rozliczenia/jak-liczymy-koszty), żeby wiedzieć, co się dzieje, gdy saldo się skończy.
3. Rozważ [automatyczne doładowanie](../konto-i-rozliczenia/automatyczne-doladowanie), jeśli uruchamiasz usługi produkcyjne.

# Hosting stron

## Jak zamówić hosting

Adres: https://pomoc.hostava.pl/hosting/zamowienie-hostingu

Wybór pakietu i okresu rozliczenia, płatność z salda oraz co dzieje się z hostingiem przy odnowieniu.

Hosting to miejsce na Twoje strony WWW, pocztę w domenie, bazy danych MySQL i konta FTP. Płacisz za niego z góry z salda konta, za miesiąc albo za rok.

#### Co zawiera hosting

- strony z bezpłatnym certyfikatem SSL i WordPressem instalowanym jednym kliknięciem,
- pocztę w Twojej domenie: skrzynki, aliasy, przekierowania i autoresponder,
- bazy danych MySQL, dostęp FTP i wybór wersji PHP,
- kopie zapasowe stron co godzinę, które przywrócisz samodzielnie z panelu.

> **Uwaga:** to hosting współdzielony — Twoje strony działają na serwerze razem ze stronami innych klientów. Sprawdzi się przy stronach firmowych, sklepach i blogach. Nie jest przeznaczony dla systemów objętych NIS2 — do nich wybierz serwer VPS, zarządzaną bazę danych i serwer logów.

#### Zamówienie krok po kroku

1. Zaloguj się do panelu https://cloud.hostava.pl.
2. W menu bocznym, w grupie **Strony i poczta**, kliknij **Podsumowanie**. Jeśli nie masz jeszcze hostingu, zobaczysz od razu formularz **Zamów hosting**.
3. W sekcji **Pakiet** wybierz **Hosting 10 GB** albo **Hosting 100 GB**. Podana pojemność to łączne miejsce na pliki, bazy danych i pocztę.
4. W sekcji **Okres rozliczenia** wybierz **Rocznie** (taniej w przeliczeniu na miesiąc) albo **Miesięcznie** (bez zobowiązania rocznego).
5. W polu **Nazwa** wpisz nazwę, pod którą zobaczysz hosting w panelu — np. swoją domenę albo nazwę firmy. Strony i domeny dodasz w następnym kroku.
6. Kliknij **Zamów i zapłać**.

Jeśli na saldzie brakuje środków, zamiast przycisku zamówienia zobaczysz **Doładuj … + VAT**. Po płatności wrócisz do formularza i dokończysz zamówienie.

Po zamówieniu panel przeniesie Cię do sekcji **Strony**. Przez chwilę zobaczysz komunikat **Konto jest przygotowywane** — zwykle trwa to krótko. Potem możesz dodać pierwszą stronę: [Dodawanie strony](../hosting/dodawanie-strony).

> **Wskazówka:** na koncie możesz mieć jeden hosting. Kolejne strony, domeny i skrzynki dodajesz w tym samym hostingu, w sekcjach **Strony** i **Poczta**.

#### Odnowienie i zawieszenie

Hosting odnawia się automatycznie z salda na koniec opłaconego okresu. Datę ważności i cenę widzisz na stronie **Podsumowanie** w karcie **Abonament** (pole **Ważny do**). Tam też znajdziesz przycisk **Odnów teraz**, jeśli chcesz przedłużyć hosting wcześniej.

Jeśli w dniu odnowienia na saldzie zabraknie pieniędzy, hosting zostanie zawieszony — strony i poczta przestaną działać. W panelu zobaczysz wtedy żółty komunikat. Doładuj saldo i kliknij **Odnów teraz**, a hosting wróci do działania.

> **Uwaga:** nie zostawiaj zawieszonego hostingu na długo. Po upływie okresu karencji hosting jest usuwany razem ze stronami, pocztą i bazami danych.

#### Dedykowany adres IP

Strony domyślnie działają na wspólnym adresie IP serwera. Jeśli potrzebujesz własnego adresu, na stronie **Podsumowanie** w karcie **Dedykowane adresy IP** kliknij **Wykup adres IP**. Pierwszy miesiąc jest pobierany od razu, kolejne co miesiąc z salda. Adres wybierzesz potem w ustawieniach strony — zobacz [Wersja PHP i ustawienia strony](../hosting/wersja-php-i-ustawienia-strony).

#### Dane dostępowe

Na stronie **Podsumowanie** znajdziesz kartę **Dane dostępowe** z adresami serwera poczty, FTP, phpMyAdmin i serwerów nazw. Każdą wartość skopiujesz jednym kliknięciem.

## Jak dodać stronę do hostingu

Adres: https://pomoc.hostava.pl/hosting/dodawanie-strony

Dodanie domeny jako nowej strony, wybór aplikacji lub pustej witryny i co panel przygotowuje automatycznie.

Każda strona w hostingu jest przypisana do domeny (np. `moja-firma.pl`) albo subdomeny (np. `sklep.moja-firma.pl`). Stron w jednym hostingu może być wiele.

#### Dodanie strony

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Strony**.
2. Kliknij **Dodaj stronę**.
3. W polu **Domena** wpisz adres strony, np. `moja-firma.pl`. Jeśli masz w panelu domeny bez strony, panel podpowie je pod polem — wystarczy kliknąć.
4. W polu **Zainstaluj aplikację** zostaw **Pusta strona** albo wybierz aplikację: WordPress, Joomla 5, Joomla 4, Laravel lub Bitrix. Więcej o WordPressie: [Instalacja WordPressa](../hosting/instalacja-wordpressa).
5. Przy pustej stronie możesz zdecydować, czy ma działać PHP — przełącznik **Obsługa PHP (PHP-FPM)**. Zostaw go włączonego, jeśli nie masz pewności.
6. Kliknij **Dodaj**.

Strona powstaje od razu. Pusta strona dostaje prostą stronę powitalną, którą zastąpisz własnymi plikami.

#### Co panel robi automatycznie

Razem ze stroną panel:

- tworzy katalog na pliki strony (widzisz go na liście stron pod nazwą domeny),
- zakłada strefę DNS domeny z rekordami strony i poczty,
- tworzy domenę pocztową — możesz od razu zakładać skrzynki, zobacz [Tworzenie skrzynki](../poczta/tworzenie-skrzynki),
- ustawia rekordy SPF, DKIM i DMARC, dzięki którym Twoje wiadomości rzadziej trafiają do spamu.

#### Aby strona była widoczna w internecie

Domena musi wskazywać na nasz serwer:

- **Domena zarejestrowana u nas** — wskazuje od razu, nic nie musisz robić.
- **Domena zarejestrowana gdzie indziej** — ustaw u jej rejestratora nasze serwery nazw `ns1.hostava.pl` i `ns2.hostava.pl`. Opisujemy to w artykule [Serwery nazw](../domeny/serwery-nazw).

Gdy domena już wskazuje na nasz serwer, włącz certyfikat SSL, aby strona działała przez `https://` — zobacz [Certyfikat SSL](../hosting/certyfikat-ssl).

#### Lista stron

Na liście w sekcji **Strony** widzisz każdą stronę z wersją PHP, stanem SSL i adresem IP. Przy stronach z WordPressem jest skrót **Panel WordPress →**. Kliknij wiersz, aby przejść do szczegółów strony. Znajdziesz tam zakładki:

- **Podsumowanie** — adres, aliasy, katalog, PHP, SSL i adres IP w skrócie,
- **Ustawienia** — domena, katalog, PHP, adres IP i SSL,
- **Opieka** — płatna opieka nad stroną WordPress (widoczna przy WordPressie),
- **Kopie zapasowe** — kopie strony i przywracanie,
- **Przekierowania i ochrona** — przekierowania adresów i katalogi chronione hasłem.

#### Wgrywanie plików

Pliki strony wgrasz przez FTP — instrukcję krok po kroku znajdziesz w artykule [FTP — wgrywanie plików](../hosting/ftp-wgrywanie-plikow). Katalog strony to `www/<domena>`, np. `www/moja-firma.pl`.

#### Usunięcie strony

Kliknij ikonę kosza na liście stron albo przycisk **Usuń** w szczegółach strony i potwierdź.

> **Uwaga:** usunięcie strony kasuje jej pliki. Strefa DNS i poczta domeny zostają — skrzynki działają dalej.

## Jak zainstalować WordPressa

Adres: https://pomoc.hostava.pl/hosting/instalacja-wordpressa

Instalacja WordPressa jednym kliknięciem przy dodawaniu strony, dane logowania i pierwsze kroki po instalacji.

WordPressa instalujesz razem z nową stroną — panel sam pobiera aplikację, tworzy bazę danych i konfiguruje ustawienia. Nie musisz niczego wgrywać przez FTP.

#### Instalacja

1. W menu bocznym kliknij **Strony**.
2. Kliknij **Dodaj stronę**.
3. W polu **Domena** wpisz adres strony, np. `moja-firma.pl`.
4. W polu **Zainstaluj aplikację** wybierz **WordPress**.
5. Kliknij **Dodaj**.

Instalacja trwa w tle zwykle kilka minut. Gdy się zakończy, na adres e-mail Twojego konta w panelu wyślemy wiadomość z danymi logowania do panelu WordPressa: adresem, loginem i hasłem.

W ten sam sposób zainstalujesz także **Joomla 5**, **Joomla 4**, **Laravel** lub **Bitrix**.

> **Uwaga:** WordPressa instalujesz przy dodawaniu nowej strony. Jeśli strona dla tej domeny już istnieje, a chcesz zacząć od nowa z WordPressem, najpierw ją usuń (razem z plikami), a potem dodaj ponownie z wybraną aplikacją.

#### Logowanie do WordPressa

Panel administracyjny WordPressa znajdziesz pod adresem `https://twoja-domena.pl/wp-admin/`. Na liście w sekcji **Strony** przy stronie z WordPressem jest też skrót **Panel WordPress →**.

Jeśli domena nie wskazuje jeszcze na nasz serwer, panel WordPressa otworzy się dopiero po zmianie DNS — zobacz [Serwery nazw](../domeny/serwery-nazw).

> **Wskazówka:** po pierwszym logowaniu zmień hasło administratora w WordPressie (**Użytkownicy → Profil**) i usuń wiadomość z danymi logowania ze skrzynki.

#### Po instalacji

1. **Włącz SSL.** W szczegółach strony, w zakładce **Ustawienia**, wybierz certyfikat **Let's Encrypt** i włącz **Przekieruj ruch na HTTPS**. Szczegóły: [Certyfikat SSL](../hosting/certyfikat-ssl).
2. **Sprawdź adres witryny.** Jeśli WordPress działał wcześniej pod innym adresem, w WordPressie ustaw właściwy adres w **Ustawienia → Ogólne**.
3. **Zadbaj o harmonogram zadań.** Jeśli wtyczki wymagają regularnego uruchamiania `wp-cron.php`, możesz dodać takie zadanie w panelu — zobacz [Zadania cron](../hosting/zadania-cron).

#### Kopie zapasowe

Pełna kopia strony (pliki, baza danych, ustawienia i certyfikat SSL) powstaje automatycznie co godzinę. Jeśli aktualizacja albo wtyczka coś zepsuje, przywrócisz stronę samodzielnie — zobacz [Kopie zapasowe stron](../hosting/kopie-zapasowe-stron).

#### Opieka nad stroną

Przy stronach z WordPressem w szczegółach strony jest zakładka **Opieka**. To płatna usługa, w której zajmujemy się aktualizacjami, kopiami i bezpieczeństwem Twojego WordPressa. Po włączeniu instalujemy na stronie lekką wtyczkę monitorującą, a w zakładce widzisz stan strony i listę wykonanych prac. Cenę zobaczysz w tej zakładce przed włączeniem; opłata jest pobierana z salda co miesiąc i możesz ją wyłączyć w każdej chwili.

#### Nie dostałem e-maila z danymi logowania

Sprawdź folder ze spamem w skrzynce, której używasz do logowania w panelu. Jeśli wiadomości nie ma, skorzystaj z opcji **Nie pamiętasz hasła?** na stronie logowania WordPressa albo napisz do pomocy technicznej.

## Certyfikat SSL dla strony

Adres: https://pomoc.hostava.pl/hosting/certyfikat-ssl

Jak włączyć bezpłatny certyfikat Let's Encrypt, przekierować ruch na HTTPS i odnowić certyfikat po dodaniu aliasu.

Certyfikat SSL sprawia, że strona działa pod adresem `https://`, a przeglądarka pokazuje kłódkę. W hostingu masz bezpłatne certyfikaty Let's Encrypt.

#### Zanim zaczniesz

Let's Encrypt wystawia certyfikat dopiero wtedy, gdy domena wskazuje na nasz serwer (bezpośrednio albo przez proxy Cloudflare). Domeny zarejestrowane u nas wskazują od razu. Przy domenie z innego rejestratora najpierw ustaw nasze serwery nazw — zobacz [Serwery nazw](../domeny/serwery-nazw). Gdy zrobisz to przed zmianą DNS, wystawienie może się nie udać.

#### Włączenie SSL

1. W menu bocznym kliknij **Strony** i wybierz stronę z listy.
2. Przejdź do zakładki **Ustawienia**.
3. W karcie **SSL**, w polu **Certyfikat SSL**, wybierz **Let's Encrypt — bezpłatny, zaufany przez przeglądarki**.
4. Włącz przełącznik **Przekieruj ruch na HTTPS**, aby odwiedzający zawsze trafiali na bezpieczną wersję strony.
5. Kliknij **Zapisz zmiany**.

Certyfikat jest wystawiany w tle i pojawia się na stronie zwykle w ciągu kilku minut. Na liście stron przy domenie zobaczysz wtedy oznaczenie **SSL**.

> **Wskazówka:** przełącznik **Przekieruj ruch na HTTPS** jest dostępny dopiero po włączeniu SSL.

#### Aliasy i odnowienie certyfikatu

Certyfikat obejmuje domenę strony i wszystkie jej aliasy (np. `www.moja-firma.pl`). Jeśli dodasz nowy alias albo przepniesz DNS domeny na nasz serwer:

1. Otwórz zakładkę **Ustawienia** strony.
2. W karcie **SSL** kliknij **Odnów certyfikat**.

Nowy certyfikat obejmie domenę i wszystkie aliasy w ciągu kilku minut. Jeśli zapisujesz alias, który jeszcze nie wskazuje na nasz serwer, panel o tym poinformuje — kliknij **Odnów certyfikat**, gdy DNS zostanie zmieniony.

> **Uwaga:** alias z gwiazdką (np. `*.inna-domena.pl`) przekieruje do strony ruch z każdej subdomeny, ale certyfikat obejmie tylko subdomeny wpisane osobno. Potrzebne subdomeny (np. `sklep.inna-domena.pl`) dodaj jako osobne aliasy.

#### Strona za Cloudflare

Jeśli korzystasz z proxy Cloudflare w trybie „Full”, możesz wybrać **Self-signed — strona za proxy Cloudflare (tryb „Full”)**. Serwer od razu obsługuje HTTPS własnym certyfikatem. Przeglądarki mu nie ufają, ale Cloudflare w trybie „Full” tak. Jeśli strona nie jest za Cloudflare, wybierz Let's Encrypt.

#### Wyłączenie SSL

W polu **Certyfikat SSL** wybierz **Wyłączony** i kliknij **Zapisz zmiany**. Przekierowanie na HTTPS wyłączy się razem z certyfikatem.

#### Najczęstsze problemy

- **Certyfikat się nie pojawia.** Sprawdź na stronie domeny (sekcja **Domeny**), czy domena jest skierowana na nasze serwery nazw. Jeśli nie — zmień je u rejestratora, odczekaj na propagację i kliknij **Odnów certyfikat**.
- **Przeglądarka ostrzega o mieszanej treści.** Strona ładuje część elementów przez `http://`. W WordPressie sprawdź adres witryny w **Ustawienia → Ogólne** — oba adresy powinny zaczynać się od `https://`.
- **Pętla przekierowań za Cloudflare.** Ustaw w Cloudflare tryb SSL „Full” zamiast „Flexible”.

## FTP — jak wgrać pliki strony

Adres: https://pomoc.hostava.pl/hosting/ftp-wgrywanie-plikow

Tworzenie konta FTP w panelu i połączenie przez FileZilla z szyfrowaniem TLS, krok po kroku.

Przez FTP wgrywasz pliki strony z komputera na serwer. Potrzebujesz konta FTP (zakładasz je w panelu) i programu FTP — w tym artykule używamy bezpłatnej FileZilli.

#### Krok 1. Utwórz konto FTP

1. W menu bocznym, pod **Strony**, kliknij **FTP**.
2. Kliknij **Dodaj konto FTP**.
3. W polu **Użytkownik** wpisz nazwę konta, np. `wgrywanie`.
4. W polu **Katalog domowy** określ, do czego konto ma dostęp:
   - `/` — całe konto hostingu (wszystkie strony),
   - `/www/moja-firma.pl` — tylko jedna strona.
5. Hasło jest wygenerowane automatycznie. Możesz wpisać własne albo kliknąć **Generuj**.
6. Zapisz hasło w bezpiecznym miejscu — panel nie pokaże go ponownie.
7. Kliknij **Utwórz**.

> **Wskazówka:** hasło musi mieć co najmniej 12 znaków. Jeśli ma mniej niż 16 znaków, musi zawierać trzy z czterech rodzajów znaków: małe litery, wielkie litery, cyfry i znaki specjalne.

#### Krok 2. Dane do połączenia

| Ustawienie | Wartość |
|---|---|
| Serwer (host) | `ftp.hostava.pl` |
| Port | `21` |
| Protokół | FTP z szyfrowaniem TLS |
| Użytkownik | nazwa z kolumny **Użytkownik** na liście kont FTP |
| Hasło | hasło konta FTP |

Adres serwera i port widzisz też nad listą kont w sekcji **FTP**.

#### Krok 3. Połącz się w FileZilli

1. Pobierz i zainstaluj FileZillę (wersja **FileZilla Client**) ze strony filezilla-project.org.
2. Otwórz **Plik → Menedżer stron**.
3. Kliknij **Nowa strona** i nadaj jej nazwę, np. `Moja strona`.
4. Na karcie **Ogólne** ustaw:
   - **Protokół:** `FTP - File Transfer Protocol`,
   - **Serwer:** `ftp.hostava.pl`,
   - **Port:** `21`,
   - **Szyfrowanie:** `Wymagaj jawnego FTP przez TLS`,
   - **Tryb logowania:** `Normalny`,
   - **Użytkownik** i **Hasło:** dane konta FTP.
5. Kliknij **Połącz**.

> **Uwaga:** nie wybieraj opcji „Używaj zwykłego FTP (niezabezpieczony)”. Bez szyfrowania hasło i pliki przesyłane są otwartym tekstem.

#### Krok 4. Wgraj pliki

Po połączeniu lewa strona okna FileZilli to Twój komputer, prawa — serwer.

1. Po prawej stronie otwórz katalog `www`, a w nim katalog swojej domeny, np. `moja-firma.pl`. Jeśli konto FTP ma katalog domowy ustawiony na jedną stronę, od razu jesteś w jej katalogu.
2. Po lewej stronie znajdź pliki strony na komputerze.
3. Zaznacz pliki i przeciągnij je na prawą stronę.

Strona główna to plik `index.php` albo `index.html` w katalogu domeny. Nowa pusta strona ma plik powitalny — nadpisz go albo usuń.

#### Zmiana hasła FTP

1. W sekcji **FTP** kliknij ikonę klucza przy koncie.
2. Wpisz nowe hasło albo kliknij **Generuj**. Ikona obok pola kopiuje hasło.
3. Kliknij **Zmień hasło**.

Programy FTP zalogowane starym hasłem trzeba będzie zalogować ponownie — w FileZilli zaktualizuj hasło w **Menedżerze stron**.

#### Usunięcie konta FTP

Kliknij ikonę kosza przy koncie i potwierdź. Pliki na serwerze pozostaną nienaruszone.

#### Problemy z połączeniem

- **Błąd logowania** — sprawdź nazwę użytkownika (dokładnie taką jak na liście kont) i hasło. W razie wątpliwości ustaw nowe hasło.
- **Połączenie zrywa się przy wyświetlaniu katalogów** — w FileZilli w **Edycja → Ustawienia → Połączenie → FTP** ustaw tryb pasywny.
- **Ostrzeżenie o certyfikacie** — upewnij się, że jako serwer wpisano dokładnie `ftp.hostava.pl`.

## Bazy danych MySQL i phpMyAdmin

Adres: https://pomoc.hostava.pl/hosting/bazy-danych-mysql

Jak utworzyć bazę danych z użytkownikiem, połączyć z nią stronę i zarządzać danymi w phpMyAdmin.

Bazy danych MySQL są potrzebne większości aplikacji, np. sklepom i systemom CMS. Przy instalacji WordPressa lub innej aplikacji z panelu baza powstaje automatycznie — ręcznie zakładasz ją, gdy wgrywasz własną aplikację albo przenosisz stronę.

#### Tworzenie bazy

1. W menu bocznym, pod **Strony**, kliknij **Bazy danych**.
2. Kliknij **Dodaj bazę**.
3. W polu **Nazwa bazy** wpisz nazwę, np. `sklep`.
4. W polu **Użytkownik** wpisz nazwę użytkownika bazy. Jeśli zostawisz je puste, użytkownik będzie nazywał się tak samo jak baza.
5. Hasło użytkownika jest wygenerowane automatycznie — możesz wpisać własne albo kliknąć **Generuj**.
6. Zapisz hasło — panel nie pokaże go ponownie.
7. Kliknij **Utwórz**.

Nowa baza pojawi się na liście z kolumnami **Nazwa**, **Host**, **Wersja** i **Użytkownicy**. Bazy są tworzone z kodowaniem `utf8mb4`, które obsługuje polskie znaki i emoji.

> **Wskazówka:** hasło musi mieć co najmniej 12 znaków, a jeśli ma mniej niż 16 — trzy z czterech rodzajów znaków (małe i wielkie litery, cyfry, znaki specjalne).

#### Dane do połączenia ze strony

| Ustawienie | Wartość |
|---|---|
| Host (serwer bazy) | `localhost` |
| Nazwa bazy | nazwa z listy baz |
| Użytkownik | użytkownik bazy |
| Hasło | hasło podane przy tworzeniu |

W WordPressie te dane wpisuje się w pliku `wp-config.php` (`DB_NAME`, `DB_USER`, `DB_PASSWORD`, `DB_HOST`).

> **Uwaga:** z bazą łączysz się z hostingu przez host `localhost`. Do pracy z danymi z komputera używaj phpMyAdmin.

#### phpMyAdmin

phpMyAdmin to narzędzie w przeglądarce do przeglądania tabel, uruchamiania zapytań SQL oraz importu i eksportu baz.

1. W sekcji **Bazy danych** kliknij **phpMyAdmin** (albo otwórz https://pma.hostava.pl).
2. Zaloguj się nazwą użytkownika bazy i jego hasłem.
3. Po lewej stronie wybierz bazę.

##### Import bazy (np. przy przenoszeniu strony)

1. W phpMyAdmin wybierz bazę po lewej stronie.
2. Otwórz zakładkę **Import**.
3. Wybierz plik `.sql` (może być spakowany jako `.sql.gz` lub `.zip`).
4. Kliknij **Importuj** na dole strony.

##### Eksport bazy

1. Wybierz bazę po lewej stronie.
2. Otwórz zakładkę **Eksport**.
3. Zostaw metodę **Szybka** i format **SQL**, kliknij **Eksportuj**.

#### Usunięcie bazy

Kliknij ikonę kosza przy bazie. Dla bezpieczeństwa musisz wpisać nazwę bazy, aby potwierdzić.

> **Uwaga:** usunięcie bazy jest nieodwracalne — wszystkie dane zostaną skasowane. Bazę strony obejmują jednak kopie zapasowe strony, z których możesz przywrócić samą bazę — zobacz [Kopie zapasowe stron](../hosting/kopie-zapasowe-stron).

#### Zajęte miejsce

Bazy danych wliczają się do pojemności hostingu razem z plikami i pocztą. Zajętość sprawdzisz na stronie **Podsumowanie** — pasek **Miejsce na pliki, bazy i pocztę**.

## Kopie zapasowe stron

Adres: https://pomoc.hostava.pl/hosting/kopie-zapasowe-stron

Jak działają automatyczne kopie stron, jak długo są przechowywane i jak samodzielnie przywrócić stronę.

Każda strona w hostingu ma automatyczne kopie zapasowe. Gdy coś pójdzie nie tak — nieudana aktualizacja, usunięty plik, zainfekowana wtyczka — przywrócisz stronę samodzielnie z panelu.

#### Co zawiera kopia

Kopia jest pełna i obejmuje:

- **pliki strony**,
- **bazę danych** strony,
- **ustawienia strony** (np. wersję PHP, aliasy),
- **certyfikat SSL**.

Kopie są szyfrowane i przechowywane poza serwerem, na którym działa strona.

#### Jak często i jak długo

Kopia każdej strony powstaje automatycznie **co godzinę**. Starsze kopie są stopniowo przerzedzane:

| Wiek kopii | Co zostaje |
|---|---|
| ostatnie 24 godziny | wszystkie kopie (co godzinę) |
| od 2 do 7 dni | jedna kopia z każdego dnia |
| od 8 do 30 dni | jedna kopia z każdego tygodnia |

Najnowsza kopia strony zostaje zawsze.

#### Lista kopii

1. W menu bocznym kliknij **Strony** i wybierz stronę.
2. Otwórz zakładkę **Kopie zapasowe**.

Przy każdej kopii widzisz datę, rozmiar i typ: **automatyczna** albo **ręczna**.

#### Ręczna kopia

Przed większą zmianą (aktualizacja WordPressa, nowa wtyczka, przebudowa strony) zrób kopię ręcznie:

1. W zakładce **Kopie zapasowe** kliknij **Utwórz kopię**.
2. Kopia pojawi się na liście po chwili.

#### Przywracanie strony

1. W zakładce **Kopie zapasowe** znajdź kopię z właściwą datą.
2. Kliknij **Przywróć**.
3. Zaznacz, co chcesz odtworzyć:
   - **Pliki strony**,
   - **Baza danych**,
   - **Ustawienia strony**,
   - **Certyfikat SSL**.
4. Kliknij **Przywróć**.

Przywracanie trwa zwykle kilka minut.

> **Uwaga:** odtworzone dane nadpisują bieżące. Jeśli od czasu kopii na stronie pojawiły się nowe zamówienia lub komentarze, przywrócenie bazy je usunie. W razie wątpliwości najpierw kliknij **Utwórz kopię**, aby zachować obecny stan.

> **Wskazówka:** możesz przywrócić tylko część — np. same pliki, gdy zepsuła się wtyczka, a bazę z zamówieniami zostawić bez zmian.

#### Usunięcie kopii

Kliknij ikonę kosza przy kopii i potwierdź. Usunięta kopia znika z magazynu na stałe.

#### Kopie poczty

Kopie stron nie obejmują poczty. Skrzynki e-mail mają osobne kopie — zobacz [Kopie poczty](../poczta/kopie-poczty).

## Jak przenieść stronę od innego dostawcy

Adres: https://pomoc.hostava.pl/hosting/przenoszenie-strony

Przeniesienie plików, bazy danych, poczty i domeny z innego hostingu bez przerwy w działaniu strony.

Przeniesienie strony polega na skopiowaniu plików i bazy danych do nowego hostingu, a na końcu na skierowaniu domeny na nasz serwer. Dopóki domena wskazuje na starego dostawcę, strona działa tam bez przerwy.

#### 1. Przygotuj hosting i stronę

1. Jeśli nie masz jeszcze hostingu, zamów go — [Zamówienie hostingu](../hosting/zamowienie-hostingu).
2. Dodaj stronę dla swojej domeny jako **Pusta strona** — [Dodawanie strony](../hosting/dodawanie-strony).
3. W ustawieniach strony ustaw tę samą wersję PHP, której strona używała u poprzedniego dostawcy — [Wersja PHP i ustawienia strony](../hosting/wersja-php-i-ustawienia-strony).

#### 2. Skopiuj pliki

1. Pobierz wszystkie pliki strony od starego dostawcy (przez jego FTP albo menedżer plików).
2. Załóż konto FTP w panelu i wgraj pliki do katalogu `www/twoja-domena.pl` — [FTP — wgrywanie plików](../hosting/ftp-wgrywanie-plikow).
3. Usuń stronę powitalną (`index.html`), jeśli Twoja strona ma plik `index.php`.

#### 3. Przenieś bazę danych

1. U starego dostawcy wyeksportuj bazę do pliku `.sql` (np. w phpMyAdmin: **Eksport → Szybka → SQL**).
2. W panelu utwórz nową bazę z użytkownikiem — [Bazy danych MySQL](../hosting/bazy-danych-mysql).
3. Zaloguj się do phpMyAdmin (https://pma.hostava.pl), wybierz nową bazę i zaimportuj plik w zakładce **Import**.
4. Zaktualizuj dane połączenia w konfiguracji strony. W WordPressie edytuj plik `wp-config.php`: `DB_NAME`, `DB_USER`, `DB_PASSWORD`, a `DB_HOST` ustaw na `localhost`.

#### 4. Przygotuj pocztę

Domena pocztowa powstała razem ze stroną. W sekcji **Poczta** utwórz skrzynki o tych samych adresach co u starego dostawcy — [Tworzenie skrzynki](../poczta/tworzenie-skrzynki).

Starej poczty panel nie przenosi automatycznie. Najprościej zrobisz to w programie pocztowym (np. Thunderbird): dodaj oba konta — stare i nowe — i przeciągnij foldery z wiadomościami ze starego konta do nowego.

#### 5. Skieruj domenę na nasz serwer

1. W sekcji **Domeny** otwórz swoją domenę. W karcie **Rejestracja domeny** kliknij **Przepisz rekordy od obecnego dostawcy** — panel odczyta typowe rekordy (np. `www`, subdomeny, weryfikacje TXT) i pozwoli przenieść je do naszej strefy.
2. U rejestratora domeny ustaw serwery nazw `ns1.hostava.pl` i `ns2.hostava.pl` — [Serwery nazw](../domeny/serwery-nazw).
3. Zmiana rozchodzi się zwykle w ciągu kilku godzin. Na stronie domeny zielony komunikat potwierdzi, że domena jest skierowana na nasze serwery.

> **Uwaga:** jeśli poczta ma działać u nas, przy przepisywaniu rekordów nie zaznaczaj rekordów MX i SPF starego dostawcy.

#### 6. Po przełączeniu

1. Włącz certyfikat SSL — [Certyfikat SSL](../hosting/certyfikat-ssl).
2. Sprawdź stronę i wysyłkę formularzy.
3. Gdy poczta dociera już do nowych skrzynek, przenieś resztę wiadomości i **usuń domenę pocztową u starego dostawcy**. Dopóki tam jest, jego serwery mogą doręczać część poczty do starych skrzynek. Panel przypomni o tym w poczcie domeny, jeśli wykryje, że poczta była wcześniej u innego dostawcy.
4. Wypowiedz stary hosting dopiero po kilku dniach poprawnego działania.

> **Wskazówka:** domenę możesz też przenieść do nas, aby wszystko mieć w jednym panelu — [Przeniesienie domeny](../domeny/przeniesienie-domeny).

## Zadania cykliczne (cron)

Adres: https://pomoc.hostava.pl/hosting/zadania-cron

Jak ustawić regularne uruchamianie adresu URL lub skryptu PHP, np. wp-cron.php albo wysyłki newslettera.

Zadania cykliczne (cron) uruchamiają wybrany adres albo skrypt PHP według harmonogramu — np. co 15 minut albo codziennie o 3:00. Przydają się do `wp-cron.php` w WordPressie, wysyłki newslettera, generowania raportów czy czyszczenia danych.

#### Dodanie zadania

1. W menu bocznym, pod **Strony**, kliknij **Cron**.
2. Kliknij **Dodaj zadanie**.
3. W polu **Co uruchamiać** wybierz jedną z opcji:
   - **Wywołanie adresu** — panel otworzy podany adres jak przeglądarka. W polu **Adres** wpisz pełny adres, np. `https://moja-firma.pl/wp-cron.php`.
   - **Skrypt PHP ze strony** — wybierz **Stronę** i w polu **Plik** podaj ścieżkę do skryptu względem katalogu strony, np. `cron.php` albo `skrypty/raport.php`.
4. W polu **Jak często** wybierz: **Co 5 minut**, **Co 15 minut**, **Co 30 minut**, **Co godzinę**, **Codziennie**, **Co tydzień** albo **Co miesiąc**.
5. Przy opcjach **Codziennie**, **Co tydzień** i **Co miesiąc** ustaw dodatkowo godzinę i minutę, a także dzień tygodnia lub dzień miesiąca (od 1 do 28).
6. Kliknij **Zapisz**.

> **Uwaga:** wywołanie adresu może trwać maksymalnie 5 minut. Dłuższe zadania podziel na mniejsze części.

#### Lista zadań

Na liście widzisz adres lub skrypt każdego zadania i jego harmonogram, np. „co 15 minut” albo „codziennie o 3:00”. Przy zadaniu masz ikony:

- **Wstrzymaj / Wznów** — czasowo wyłącza zadanie bez usuwania,
- **Edytuj** — zmiana adresu, skryptu lub harmonogramu,
- **Usuń** — zadanie przestanie być uruchamiane.

Jeśli na liście widnieje **Zadanie dodane poza panelem**, możesz je wstrzymać lub usunąć, ale nie edytować.

#### Przykład: WordPress i wp-cron.php

WordPress uruchamia swoje zadania (publikacja zaplanowanych wpisów, kopie wtyczek) przy odwiedzinach strony. Przy małym ruchu zadania mogą się opóźniać, a przy dużym — obciążać stronę. Lepiej uruchamiać je harmonogramem:

1. Dodaj zadanie **Wywołanie adresu** z adresem `https://twoja-domena.pl/wp-cron.php` i ustaw **Co 15 minut**.
2. W pliku `wp-config.php` dopisz linię `define('DISABLE_WP_CRON', true);` — WordPress przestanie uruchamiać zadania przy każdych odwiedzinach.

> **Wskazówka:** jeśli strona ma włączone przekierowanie na HTTPS, w adresie zadania od razu używaj `https://`.

#### Zadanie nie działa?

- Otwórz adres zadania w przeglądarce i sprawdź, czy strona odpowiada bez błędu.
- Upewnij się, że adres nie jest chroniony hasłem (zakładka **Przekierowania i ochrona** w ustawieniach strony).
- Przy skrypcie PHP sprawdź, czy ścieżka jest podana względem katalogu strony i kończy się na `.php`.

## Wersja PHP i ustawienia strony

Adres: https://pomoc.hostava.pl/hosting/wersja-php-i-ustawienia-strony

Zmiana wersji PHP, aliasów domeny, katalogu publicznego, przekierowania www, adresu IP oraz przekierowań i ochrony hasłem.

Ustawienia każdej strony znajdziesz w jej szczegółach: w menu bocznym kliknij **Strony**, wybierz stronę z listy i otwórz zakładkę **Ustawienia**. Po zmianach kliknij **Zapisz zmiany** na dole strony.

#### Wersja PHP

1. W karcie **PHP i adres IP** rozwiń listę **Wersja PHP**.
2. Wybierz wersję. **Domyślna (native)** to wersja domyślna serwera; pozostałe pozycje to konkretne wersje, np. PHP 8.2.
3. Kliknij **Zapisz zmiany**.

> **Wskazówka:** przed zmianą wersji PHP zrób kopię strony (zakładka **Kopie zapasowe → Utwórz kopię**). Starsze wtyczki lub szablony mogą nie działać z nowszym PHP — wtedy wrócisz do poprzedniej wersji jednym kliknięciem.

#### Domena i katalog

W karcie **Domena i katalog** ustawisz:

- **Aliasy** — dodatkowe domeny, które mają pokazywać tę samą stronę, oddzielone spacją, np. `www.moja-firma.pl moja-firma.com.pl`. Jeśli masz w panelu inne domeny bez własnej strony, zaznaczysz je w polu **Inne domeny konta** — panel doda domenę razem z `www`, ustawi rekordy DNS (dla domen na naszych serwerach nazw) i dołoży je do certyfikatu SSL.
- **Katalog publiczny** — zostaw puste, aby strona była serwowana z katalogu domeny. Dla aplikacji Laravel lub Symfony wpisz `public` (albo `public_html`, jeśli tak nazywa się katalog w Twojej aplikacji).
- **Przekierowanie www** — **Bez przekierowania**, **Na adres z www** albo **Na adres bez www**.

> **Wskazówka:** przenosisz stronę testową na docelową domenę? Dodaj domenę docelową jako alias — bez kopiowania plików. W WordPressie zmień wtedy adres witryny w **Ustawienia → Ogólne**. Po dodaniu aliasu kliknij **Odnów certyfikat** w karcie **SSL**.

#### Adres IP

Strony domyślnie działają na wspólnym adresie IP. W polu **Adres IP** możesz:

- kliknąć **Wykup dedykowany IP**, aby kupić własny adres (płatny co miesiąc z salda),
- wybrać z listy adres, który już masz.

Ustawienia certyfikatu SSL opisujemy w artykule [Certyfikat SSL](../hosting/certyfikat-ssl).

#### Przekierowania

W zakładce **Przekierowania i ochrona**, w karcie **Przekierowania**:

1. Kliknij **Dodaj**.
2. W polu **Adres na stronie** wpisz ścieżkę od „/”, np. `/stara-oferta`. Aby przekierować całą stronę, wpisz `/`.
3. W polu **Przekieruj na** podaj pełny adres, np. `https://moja-firma.pl/nowa-oferta`.
4. W polu **Rodzaj** wybierz **Stałe (301)** — wyszukiwarki przeniosą pozycję na nowy adres — albo **Tymczasowe (302)**, np. na czas promocji.
5. Kliknij **Zapisz**.

#### Katalogi chronione hasłem

W tej samej zakładce, w karcie **Katalogi chronione hasłem**, zabezpieczysz np. wersję testową strony:

1. Kliknij **Dodaj**.
2. W polu **Katalog** wpisz ścieżkę, np. `/admin`, albo `/` dla całej strony.
3. Podaj **Login** (małe litery, cyfry, kropka, myślnik) i **Hasło** (lub kliknij **Generuj**).
4. Kliknij **Zapisz**.

Przeglądarka zapyta o login i hasło przed wejściem do katalogu. Kolejnych użytkowników dodasz przyciskiem **Użytkownik** przy katalogu. Ikona kosza przy katalogu wyłącza ochronę.

#### Podgląd ustawień

Zakładka **Podsumowanie** pokazuje wszystkie najważniejsze ustawienia strony w skrócie: adres, aliasy, katalog publiczny, PHP, SSL, przekierowanie www i adres IP.

# Poczta e-mail

## Jak utworzyć skrzynkę e-mail

Adres: https://pomoc.hostava.pl/poczta/tworzenie-skrzynki

Zakładanie skrzynki w domenie, limit miejsca, zmiana hasła, wstrzymanie i usunięcie skrzynki.

Skrzynkę e-mail zakładasz w domenie pocztowej, np. `kontakt@moja-firma.pl`. Domena pocztowa powstaje automatycznie, gdy dodajesz stronę — zostaje tylko utworzyć skrzynki.

#### Tworzenie skrzynki

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Poczta**.
2. Kliknij domenę, w której chcesz założyć skrzynkę.
3. Kliknij **Dodaj skrzynkę** w prawym górnym rogu.
4. W polu **Adres** wpisz część przed znakiem @, np. `kontakt`. Domena jest dopisana automatycznie.
5. Hasło jest wygenerowane automatycznie — możesz wpisać własne albo kliknąć **Generuj**.
6. W polu **Limit miejsca (MB)** zostaw `1024` (1 GB), wpisz inną wartość albo `0`, aby skrzynka nie miała osobnego limitu.
7. Zapisz hasło w bezpiecznym miejscu i kliknij **Utwórz**.

Skrzynka działa od razu. Możesz się do niej zalogować przez przeglądarkę — [Poczta przez przeglądarkę](../poczta/poczta-przez-przegladarke) — albo skonfigurować program pocztowy — [Konfiguracja programu pocztowego](../poczta/konfiguracja-programu-pocztowego).

> **Wskazówka:** hasło musi mieć co najmniej 12 znaków. Jeśli ma mniej niż 16 znaków, musi zawierać trzy z czterech rodzajów znaków: małe litery, wielkie litery, cyfry i znaki specjalne. Nie może zawierać nazwy skrzynki ani domeny.

> **Uwaga:** wszystkie skrzynki korzystają z pojemności hostingu wspólnej dla plików, baz danych i poczty. Limit skrzynki pomaga pilnować, żeby jedna skrzynka nie zajęła całego miejsca.

#### Brak domeny na liście?

Jeśli w sekcji **Poczta** nie ma domeny, której potrzebujesz, kliknij **Dodaj domenę**, wpisz domenę i kliknij **Dodaj**. Aby skrzynki odbierały pocztę, rekord MX domeny musi wskazywać na nasz serwer. Przy domenach na naszych serwerach nazw ustawiamy go automatycznie — zobacz [Serwery nazw](../domeny/serwery-nazw).

#### Ustawienia skrzynki

W zakładce **Skrzynki** kliknij adres skrzynki. Otworzy się okno, w którym:

- zmienisz **Limit miejsca (MB)**,
- dodasz **Aliasy** i **Przekierowanie** — [Aliasy i przekierowania](../poczta/aliasy-i-przekierowania),
- ustawisz hasło,
- włączysz **Odpowiedź automatyczną** — [Autoresponder](../poczta/autoresponder),
- pobierzesz **Profil dla iPhone/Mac**,
- wstrzymasz skrzynkę.

Zmiany zapisujesz przyciskiem **Zapisz ustawienia**.

#### Zmiana hasła

1. W oknie ustawień skrzynki wpisz nowe hasło w polu **Nowe hasło** albo kliknij **Generuj**.
2. Kliknij **Zmień**.

Po zmianie hasła zaktualizuj je we wszystkich programach i telefonach, w których skonfigurowana jest skrzynka. Użytkownik skrzynki może też sam zmienić hasło w webmailu — zobacz [Poczta przez przeglądarkę](../poczta/poczta-przez-przegladarke).

#### Wstrzymanie skrzynki

Na dole okna ustawień kliknij **Wstrzymaj**. Wstrzymana skrzynka nie odbiera poczty i nie pozwala się zalogować, ale wiadomości zostają. Na liście ma oznaczenie **wstrzymana**. Aby ją przywrócić, kliknij **Wznów**.

> **Wskazówka:** wstrzymanie przydaje się np. po odejściu pracownika — dostęp jest zablokowany, a poczta pozostaje do wglądu po wznowieniu.

#### Usunięcie skrzynki

W zakładce **Skrzynki** kliknij ikonę kosza przy skrzynce i potwierdź.

> **Uwaga:** usunięcie skrzynki kasuje całą jej pocztę i nie można go cofnąć.

#### Historia logowań

W zakładce **Historia logowań** (albo przyciskiem **Logowania** przy skrzynce) sprawdzisz, kiedy i z jakich adresów IP logowano się do skrzynki — z programów pocztowych, webmaila i przy wysyłce. Historia jest przechowywana 12 miesięcy i można ją pobrać jako plik CSV. Jeśli widzisz udane logowanie z nieznanego adresu, od razu zmień hasło skrzynki.

## Konfiguracja programu pocztowego

Adres: https://pomoc.hostava.pl/poczta/konfiguracja-programu-pocztowego

Ustawienia IMAP, POP3 i SMTP dla Thunderbirda, Outlooka, iPhone'a, Maca i aplikacji Gmail na Androidzie.

Skrzynkę możesz obsługiwać w dowolnym programie pocztowym. Login to zawsze **pełny adres e-mail**, a hasło — hasło skrzynki.

#### Ustawienia serwera

| Ustawienie | Serwer | Port | Szyfrowanie |
|---|---|---|---|
| Poczta przychodząca (IMAP) — zalecane | `poczta.hostava.pl` | `993` | SSL/TLS |
| Poczta przychodząca (POP3) | `poczta.hostava.pl` | `995` | SSL/TLS |
| Poczta wychodząca (SMTP) | `poczta.hostava.pl` | `465` | SSL/TLS |
| Poczta wychodząca (SMTP) — alternatywnie | `poczta.hostava.pl` | `587` | STARTTLS |

- **Nazwa użytkownika:** pełny adres, np. `kontakt@moja-firma.pl` — zarówno dla poczty przychodzącej, jak i wychodzącej.
- **Uwierzytelnianie:** zwykłe hasło (normalne hasło). Serwer poczty wychodzącej wymaga logowania.

Te same dane znajdziesz w panelu: na stronie **Podsumowanie** w karcie **Dane dostępowe** oraz w poczcie domeny, w zakładce **Podsumowanie** (karta **Ustawienia programu pocztowego**).

> **Wskazówka:** wybieraj IMAP. Wiadomości zostają na serwerze, więc widzisz to samo w telefonie, komputerze i webmailu, a poczta jest objęta kopiami zapasowymi. POP3 pobiera pocztę na jedno urządzenie.

#### Thunderbird

Thunderbird skonfiguruje się sam:

1. Otwórz **Menu → Konto → Poczta e-mail** (przy pierwszym uruchomieniu kreator otworzy się automatycznie).
2. Wpisz imię i nazwisko, adres e-mail i hasło skrzynki.
3. Kliknij **Kontynuuj** — Thunderbird odczyta ustawienia serwera.
4. Upewnij się, że wybrany jest **IMAP**, i kliknij **Gotowe**.

Jeśli ustawienia nie zostaną wykryte, kliknij **Konfiguruj ręcznie** i wpisz dane z tabeli powyżej.

#### Outlook

1. W Outlooku wybierz **Plik → Dodaj konto** (w nowym Outlooku: **Ustawienia → Konta → Dodaj konto**).
2. Wpisz adres e-mail i kliknij **Połącz**.
3. Jeśli Outlook poprosi o typ konta, wybierz **IMAP**.
4. Wpisz ustawienia z tabeli: poczta przychodząca `poczta.hostava.pl`, port `993`, SSL/TLS; poczta wychodząca `poczta.hostava.pl`, port `465`, SSL/TLS (albo `587` i STARTTLS).
5. Wpisz hasło skrzynki i zakończ kreator.

#### iPhone, iPad i Mac (Apple Mail)

Najwygodniej użyć gotowego profilu z panelu:

1. Na iPhonie lub iPadzie otwórz panel https://cloud.hostava.pl w przeglądarce Safari i zaloguj się.
2. Przejdź do **Poczta**, wybierz domenę, otwórz zakładkę **Skrzynki** i kliknij skrzynkę.
3. Kliknij **Profil dla iPhone/Mac** i zezwól na pobranie.
4. Otwórz **Ustawienia** — na górze pojawi się **Pobrano profil**. Stuknij go i wybierz **Instaluj**.
5. Podaj hasło skrzynki, gdy system o nie poprosi.

Profil nie jest podpisany, dlatego system może pokazać go jako **Niezweryfikowany** — to normalne. Na Macu pobrany plik otwórz dwukrotnym kliknięciem i zainstaluj w **Ustawieniach systemowych** (sekcja profili).

Ręcznie: **Ustawienia → Aplikacje → Mail → Konta → Dodaj konto → Inne → Dodaj konto Mail**, wybierz **IMAP** i wpisz `poczta.hostava.pl` jako serwer poczty przychodzącej i wychodzącej, a pełny adres e-mail jako nazwę użytkownika.

#### Android — aplikacja Gmail

1. Otwórz aplikację Gmail, stuknij swoje zdjęcie profilowe i wybierz **Dodaj kolejne konto**.
2. Wybierz **Inne**.
3. Wpisz adres e-mail i stuknij **Ręczna konfiguracja**.
4. Wybierz **Osobiste (IMAP)**.
5. Wpisz hasło skrzynki.
6. **Ustawienia serwera przychodzącego:** serwer `poczta.hostava.pl`, port `993`, typ zabezpieczeń **SSL/TLS**, nazwa użytkownika — pełny adres e-mail.
7. **Ustawienia serwera wychodzącego:** zaznacz wymaganie logowania, serwer `poczta.hostava.pl`, port `465`, typ zabezpieczeń **SSL/TLS**.
8. Dokończ kreator.

#### Najczęstsze problemy

- **Błąd logowania** — sprawdź, czy jako nazwy użytkownika używasz pełnego adresu e-mail, a nie samej części przed @. Upewnij się, że skrzynka nie jest wstrzymana.
- **Odbieranie działa, wysyłanie nie** — sprawdź port i szyfrowanie serwera wychodzącego (`465` + SSL/TLS albo `587` + STARTTLS) i czy włączone jest logowanie do serwera wychodzącego.
- **Ostrzeżenie o certyfikacie** — jako serwer wpisz dokładnie `poczta.hostava.pl`, a nie np. `mail.twoja-domena.pl`.

## Poczta przez przeglądarkę (webmail)

Adres: https://pomoc.hostava.pl/poczta/poczta-przez-przegladarke

Jak zalogować się do webmaila, gdzie znaleźć folder Spam i jak samodzielnie zmienić hasło skrzynki.

Webmail pozwala czytać i wysyłać pocztę w przeglądarce, bez instalowania programu pocztowego — na dowolnym komputerze lub telefonie.

#### Logowanie

1. Otwórz w przeglądarce https://webmail.hostava.pl.
2. W polu nazwy użytkownika wpisz **pełny adres e-mail**, np. `kontakt@moja-firma.pl`.
3. Wpisz hasło skrzynki i zaloguj się.

Do webmaila przejdziesz też z panelu — przycisk **Webmail** znajdziesz na stronie **Podsumowanie**, w sekcji **Poczta** i w poczcie każdej domeny.

> **Wskazówka:** adres webmaila jest taki sam dla wszystkich Twoich domen i skrzynek. Możesz przekazać go pracownikom razem z adresem i hasłem ich skrzynki.

#### Foldery

Po zalogowaniu po lewej stronie widzisz foldery: odebrane, wysłane, kopie robocze, kosz i **Spam**. Do folderu **Spam** trafiają wiadomości, które serwer oznaczył jako niechciane — warto czasem do niego zajrzeć. Więcej: [Spam i ochrona poczty](../poczta/spam-i-ochrona-poczty).

Jeśli przywracasz pocztę z kopii zapasowej, przywrócone wiadomości pojawią się w osobnym folderze **Przywrocone** z datą — zobacz [Kopie poczty](../poczta/kopie-poczty).

#### Zmiana hasła w webmailu

Każdy użytkownik może sam zmienić hasło swojej skrzynki, bez dostępu do panelu:

1. Zaloguj się do webmaila.
2. Kliknij **Ustawienia**.
3. Wybierz **Hasło**.
4. Wpisz obecne hasło, a następnie dwa razy nowe hasło.
5. Zapisz zmiany.

Nowe hasło musi spełniać te same zasady co w panelu: co najmniej 12 znaków, a jeśli ma mniej niż 16 znaków — trzy z czterech rodzajów znaków (małe litery, wielkie litery, cyfry, znaki specjalne). Nie może zawierać popularnych słów ani nazwy skrzynki czy domeny.

> **Uwaga:** po kilku nieudanych próbach podania obecnego hasła zmiana hasła zostanie czasowo zablokowana. Odczekaj kwadrans albo poproś właściciela konta o ustawienie nowego hasła w panelu.

Po zmianie hasła zaktualizuj je w programach pocztowych i telefonach, w których skonfigurowana jest skrzynka.

#### Nie pamiętasz hasła?

Webmail nie ma funkcji przypominania hasła. Nowe hasło ustawi właściciel konta w panelu: **Poczta** → domena → zakładka **Skrzynki** → skrzynka → pole **Nowe hasło** → **Zmień**. Szczegóły: [Tworzenie skrzynki](../poczta/tworzenie-skrzynki).

#### Odpowiedź automatyczna i przekierowania

Odpowiedź automatyczną (np. na czas urlopu) oraz przekierowania ustawisz w panelu, w ustawieniach skrzynki — zobacz [Autoresponder](../poczta/autoresponder) oraz [Aliasy i przekierowania](../poczta/aliasy-i-przekierowania).

#### Bezpieczeństwo

- Na komputerach współdzielonych zawsze się wylogowuj.
- Logowania do webmaila są zapisywane w historii logowań skrzynki, którą właściciel konta sprawdzi w panelu (zakładka **Historia logowań** w poczcie domeny).

## Aliasy i przekierowania poczty

Adres: https://pomoc.hostava.pl/poczta/aliasy-i-przekierowania

Dodatkowe adresy dla skrzynki, przekazywanie poczty na inne adresy, aliasy całych domen i obsługa nieistniejących adresów (catch-all).

Nie każdy adres e-mail musi być osobną skrzynką. Aliasy i przekierowania pozwalają kierować pocztę z wielu adresów do jednej skrzynki albo przesyłać ją dalej.

#### Alias skrzynki — dodatkowy adres

Alias to dodatkowy adres w tej samej domenie, z którego poczta trafia do istniejącej skrzynki. Przykład: wiadomości na `biuro@moja-firma.pl` i `kontakt@moja-firma.pl` trafiają do skrzynki `jan@moja-firma.pl`.

1. W menu bocznym kliknij **Poczta** i wybierz domenę.
2. Otwórz zakładkę **Skrzynki** i kliknij skrzynkę.
3. W polu **Aliasy** wpisz nazwy przed znakiem @, każdą w osobnej linii, np.:
   ```
   biuro
   kontakt
   ```
4. Kliknij **Zapisz ustawienia**.

> **Wskazówka:** alias musi być w tej samej domenie co skrzynka. Jeśli chcesz, żeby skrzynka odbierała pocztę z innej domeny, użyj aliasu domeny (opis niżej).

#### Przekierowanie — kopia poczty na inny adres

Przekierowanie wysyła każdą wiadomość ze skrzynki na inny adres, np. prywatny.

1. W ustawieniach skrzynki, w polu **Przekierowanie**, wpisz adresy docelowe — każdy w osobnej linii (maksymalnie 10).
2. Zdecyduj, czy wiadomość ma zostać także w skrzynce — przełącznik **Zostaw kopię w tej skrzynce**. Gdy go wyłączysz, poczta trafi tylko na adresy docelowe.
3. Kliknij **Zapisz ustawienia**.

Aby wyłączyć przekierowanie, wyczyść pole **Przekierowanie** i zapisz.

> **Uwaga:** przekierowana poczta zawiera też część spamu, który dotarł do skrzynki. Niektóre zewnętrzne serwery mogą wtedy oceniać przekierowania surowiej.

#### Aliasy domen — ta sama poczta w kilku domenach

Jeśli masz kilka domen (np. `moja-firma.pl` i `moja-firma.com.pl`), możesz sprawić, by druga domena przyjmowała pocztę dla wszystkich skrzynek z pierwszej:

1. W sekcji **Poczta** wybierz domenę główną (tę ze skrzynkami).
2. Otwórz zakładkę **Aliasy i przekierowania**.
3. W karcie **Aliasy domen** zaznacz domeny, które mają być aliasami.
4. Kliknij **Zapisz**.

Od tej chwili np. `jan@moja-firma.com.pl` trafi do skrzynki `jan@moja-firma.pl`. Dotyczy to także skrzynek dodanych później.

Domena-alias musi mieć rekord MX wskazujący na nasz serwer poczty. Przy domenach na naszych serwerach nazw ustawiamy go automatycznie.

#### Poczta na nieistniejące adresy (catch-all)

W tej samej zakładce, w karcie **Poczta na nieistniejące adresy**, zdecydujesz, co się dzieje z wiadomością wysłaną na adres, dla którego nie ma skrzynki ani aliasu (np. z literówką):

- **Odrzuć** — nadawca dostanie informację, że adres nie istnieje (zalecane),
- **Przekaż na wybrany adres (tzw. catch-all)** — wpisz adres w polu **Przekazuj na**,
- **Usuń bez informowania nadawcy**.

Kliknij **Zapisz**.

> **Uwaga:** na adres catch-all trafia dużo spamu, bo spamerzy często wysyłają na zgadywane adresy. Włączaj tę opcję tylko wtedy, gdy naprawdę jej potrzebujesz.

#### Kiedy co wybrać

| Potrzeba | Rozwiązanie |
|---|---|
| Kilka adresów, jedna osoba | alias skrzynki |
| Poczta ma trafiać też na inny adres | przekierowanie |
| Ta sama poczta w drugiej domenie | alias domeny |
| Osobne logowanie i hasło | nowa skrzynka — [Tworzenie skrzynki](../poczta/tworzenie-skrzynki) |

## Odpowiedź automatyczna (autoresponder)

Adres: https://pomoc.hostava.pl/poczta/autoresponder

Jak włączyć automatyczną odpowiedź na czas urlopu lub nieobecności i jak ją wyłączyć.

Odpowiedź automatyczna wysyła nadawcom ustaloną wiadomość, np. „Jestem na urlopie do 15 sierpnia”. Poczta nadal trafia do skrzynki jak zwykle.

#### Włączenie odpowiedzi automatycznej

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Poczta**.
2. Wybierz domenę i otwórz zakładkę **Skrzynki**.
3. Kliknij skrzynkę, dla której chcesz ustawić odpowiedź.
4. W oknie ustawień znajdź sekcję **Odpowiedź automatyczna** i włącz przełącznik.
5. W polu **Temat** wpisz temat odpowiedzi, np. `Jestem na urlopie`. Jeśli zostawisz pole puste, temat będzie brzmiał „Odpowiedź automatyczna”.
6. W polu **Treść** wpisz wiadomość.
7. Kliknij **Zapisz odpowiedź automatyczną**.

Panel potwierdzi komunikatem **Autoresponder włączony**.

> **Wskazówka:** przycisk **Zapisz odpowiedź automatyczną** zapisuje samą odpowiedź. Jeśli w tym samym oknie zmieniasz też inne ustawienia skrzynki (np. przekierowanie), zapisz je przyciskiem **Zapisz ustawienia** na dole okna.

#### Przykładowa treść

```
Dzień dobry,

dziękuję za wiadomość. Do 15 sierpnia jestem na urlopie i nie mam dostępu do poczty.
W pilnych sprawach proszę pisać na adres biuro@moja-firma.pl lub dzwonić pod numer 600 100 200.

Pozdrawiam
Jan Kowalski
```

Dobra odpowiedź zawiera:

- datę powrotu,
- informację, do kogo zwrócić się w pilnej sprawie,
- podpis.

> **Uwaga:** nie podawaj w odpowiedzi automatycznej informacji, które nie powinny trafić do obcych osób (np. prywatnego numeru telefonu) — odpowiedź dostanie każdy nadawca, także nieznany.

#### Wyłączenie odpowiedzi automatycznej

Odpowiedź nie wyłącza się sama — pamiętaj o tym po powrocie:

1. Otwórz ustawienia skrzynki tak jak przy włączaniu.
2. Wyłącz przełącznik **Odpowiedź automatyczna**.
3. Kliknij **Zapisz odpowiedź automatyczną**.

Panel potwierdzi komunikatem **Autoresponder wyłączony**.

#### Odpowiedź automatyczna a przekierowanie

Możesz jednocześnie włączyć odpowiedź automatyczną i przekierowanie poczty na zastępcę. Nadawca dostanie wtedy informację o Twojej nieobecności, a zastępca — kopię wiadomości. Jak ustawić przekierowanie, opisujemy w artykule [Aliasy i przekierowania](../poczta/aliasy-i-przekierowania).

#### Kto może włączyć odpowiedź?

Odpowiedź automatyczną ustawia się w panelu klienta, w ustawieniach skrzynki. Jeśli pracownik nie ma dostępu do panelu, poproś właściciela konta o jej włączenie. Więcej o ustawieniach skrzynki: [Tworzenie skrzynki](../poczta/tworzenie-skrzynki).

## Spam i ochrona poczty

Adres: https://pomoc.hostava.pl/poczta/spam-i-ochrona-poczty

Jak działa filtr spamu i antywirus, co robią rekordy SPF, DKIM i DMARC oraz jak sprawdzić stan poczty domeny.

Poczta w hostingu jest chroniona po obu stronach: przychodzące wiadomości sprawdza filtr spamu i antywirus, a Twoje wysyłane wiadomości są podpisywane, żeby odbiorcy wiedzieli, że pochodzą naprawdę od Ciebie.

#### Filtr spamu

Każda wiadomość przychodząca jest oceniana przez filtr spamu. Wiadomości ocenione jako spam nie są usuwane — trafiają do folderu **Junk**, który w webmailu i w większości programów pocztowych nazywa się **Spam** lub **Niechciane**.

> **Wskazówka:** co jakiś czas zajrzyj do folderu Spam. Jeśli znajdziesz tam ważną wiadomość, przenieś ją do Odebranych i dodaj nadawcę do kontaktów w programie pocztowym.

Jeśli nie widzisz folderu Spam w programie pocztowym, sprawdź listę subskrybowanych folderów (w Thunderbirdzie: prawy przycisk na koncie → **Subskrybuj**).

#### Antywirus

Wiadomości zawierające wirusy są odrzucane przez serwer i nie trafiają do skrzynki. Nadawca dostaje informację o odrzuceniu.

> **Uwaga:** żaden filtr nie zatrzyma wszystkiego. Nie otwieraj nieoczekiwanych załączników i nie klikaj linków w wiadomościach z prośbą o podanie hasła lub danych do płatności.

#### SPF, DKIM i DMARC — ustawiane automatycznie

Gdy dodajesz stronę lub domenę pocztową, panel sam ustawia w strefie DNS domeny trzy rekordy, dzięki którym Twoje wiadomości rzadziej trafiają do spamu u odbiorców:

- **SPF** (uprawnieni nadawcy) — mówi odbiorcom, że nasz serwer może wysyłać pocztę z Twojej domeny,
- **DKIM** (podpis wiadomości) — potwierdza, że wiadomość nie została zmieniona po drodze,
- **DMARC** (polityka domeny) — mówi odbiorcom, co robić z podrobionymi wiadomościami.

Działa to automatycznie dla domen korzystających z naszych serwerów nazw.

#### Sprawdzenie stanu poczty domeny

1. W menu bocznym kliknij **Poczta** i wybierz domenę.
2. W zakładce **Podsumowanie** zobaczysz kartę ze stanem poczty: **Poczta skonfigurowana poprawnie** albo **Poczta wymaga uwagi**.
3. Kliknij **Pokaż szczegóły**, aby zobaczyć stan rekordów MX, SPF, DKIM i DMARC.

Jeśli czegoś brakuje w domenie na naszych serwerach nazw, otwórz domenę w sekcji **Domeny** i kliknij **Odnów DNS** — panel uzupełni brakujące rekordy.

Jeśli domena korzysta z zewnętrznego DNS (np. Cloudflare), panel pokaże przy brakującym rekordzie jego typ, nazwę i wartość do skopiowania. Dodaj go u swojego dostawcy DNS.

> **Uwaga:** jeśli masz już rekord SPF, nie dodawaj drugiego. Dopisz brakujące fragmenty do istniejącego rekordu.

#### Zaostrzenie polityki DMARC

Na start DMARC ma politykę `p=none` — odbiorcy tylko raportują podrobione wiadomości. Gdy SPF i DKIM działają poprawnie, możesz ją zaostrzyć w szczegółach stanu poczty:

- **Ustaw quarantine** — podrobione wiadomości trafią u odbiorców do spamu,
- **Ustaw reject** — podrobione wiadomości będą odrzucane.

> **Uwaga:** zanim zaostrzysz politykę, upewnij się, że wszystkie usługi wysyłające pocztę z Twojej domeny (sklep, system faktur, newsletter, CRM) wysyłają przez nasz serwer albo mają własny wpis w SPF i podpis DKIM. Inaczej ich wiadomości przestaną docierać. Bezpieczniej najpierw ustawić quarantine na kilka tygodni. W razie problemów kliknij **Złagodź do none**.

#### Szyfrowane połączenia

Programy pocztowe łączą się z serwerem wyłącznie szyfrowanymi połączeniami (SSL/TLS lub STARTTLS) — zobacz [Konfiguracja programu pocztowego](../poczta/konfiguracja-programu-pocztowego).

#### Historia logowań

W poczcie domeny, w zakładce **Historia logowań**, sprawdzisz logowania do każdej skrzynki z adresami IP i wynikiem (udane/nieudane). Nieznany adres IP z udanym logowaniem? Natychmiast zmień hasło skrzynki — [Tworzenie skrzynki](../poczta/tworzenie-skrzynki).

## Kopie zapasowe poczty

Adres: https://pomoc.hostava.pl/poczta/kopie-poczty

Jak działają automatyczne kopie skrzynek i jak przywrócić usunięte wiadomości do osobnego folderu.

Wszystkie skrzynki e-mail w hostingu mają automatyczne kopie zapasowe. Jeśli ktoś przypadkiem usunie wiadomości albo cały folder, odzyskasz je samodzielnie w panelu.

#### Jak działają kopie

- Kopie wszystkich skrzynek wykonujemy **co godzinę**. Raz na dobę powstaje kopia pełna, a w pozostałych godzinach — kopie przyrostowe (tylko zmiany).
- Kopie przechowujemy przez **7 dni**.
- Kopie są zaszyfrowane i przechowywane poza serwerem poczty.

> **Uwaga:** wiadomość, która przyszła i została usunięta w ciągu tej samej godziny, mogła nie trafić do żadnej kopii. Wiadomości usunięte ponad 7 dni temu nie da się już odzyskać z kopii.

#### Przywracanie wiadomości

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Poczta**.
2. Kliknij **Kopie poczty** (albo wejdź w domenę, otwórz zakładkę **Kopie zapasowe** i kliknij **Przywróć z kopii**).
3. W polu **Domena** wybierz domenę.
4. W polu **Skrzynka** wybierz skrzynkę, którą chcesz przywrócić.
5. W sekcji **Stan z chwili** zaznacz moment, z którego chcesz odzyskać pocztę. Przy każdym punkcie widzisz, czy to kopia **pełna** czy **przyrostowa**, oraz jej rozmiar.
6. Kliknij **Przywróć skrzynkę**.

Po zakończeniu panel pokaże, ile wiadomości przywrócono i do jakiego folderu.

#### Gdzie znajdę przywróconą pocztę

Przywrócone wiadomości trafiają do **osobnego folderu „Przywrocone” z datą** w wybranej skrzynce. Nic nie zostaje nadpisane ani usunięte — obecna zawartość skrzynki pozostaje bez zmian.

Folder zobaczysz w webmailu (https://webmail.hostava.pl) i w programie pocztowym korzystającym z IMAP. Jeśli program go nie pokazuje, odśwież listę folderów lub sprawdź subskrypcje folderów.

> **Wskazówka:** przejrzyj przywrócony folder, przenieś potrzebne wiadomości do właściwych folderów, a resztę usuń, żeby nie zajmowała miejsca.

#### Jak wybrać moment kopii

- Wiadomości zniknęły dziś rano? Wybierz punkt sprzed tej chwili, np. z wczorajszego wieczoru.
- Nie wiesz, kiedy wiadomości zniknęły? Wybierz najstarszy dostępny punkt — odzyskasz najwięcej. Wiadomości, które już są w skrzynce, pojawią się wtedy w folderze przywróconym jako duplikaty.

#### Kopie poczty a POP3

Kopie obejmują tylko wiadomości przechowywane na serwerze. Jeśli program pocztowy pobiera pocztę przez POP3 i usuwa ją z serwera, takie wiadomości są tylko na Twoim komputerze. Dlatego zalecamy IMAP — zobacz [Konfiguracja programu pocztowego](../poczta/konfiguracja-programu-pocztowego).

#### Kopie stron

Kopie poczty są niezależne od kopii stron. Pliki i bazy danych stron przywracasz w ustawieniach strony — zobacz [Kopie zapasowe stron](../hosting/kopie-zapasowe-stron).

# Domeny i DNS

## Jak zarejestrować domenę

Adres: https://pomoc.hostava.pl/domeny/rejestracja-domeny

Sprawdzenie dostępności domeny, dane abonenta (PESEL lub NIP), zakup z salda i automatyczne odnawianie.

Domenę zarejestrujesz w panelu w kilka minut. Opłata jest pobierana z salda konta, a domena od razu korzysta z naszych serwerów DNS — wystarczy dodać do niej stronę i pocztę.

#### Krok 1. Sprawdź, czy domena jest wolna

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Domeny**.
2. Otwórz zakładkę **Zarejestruj domenę**.
3. Wpisz nazwę, np. `mojafirma` albo `mojafirma.pl`, i kliknij **Sprawdź**.
4. Na liście zobaczysz wynik dla różnych rozszerzeń: **wolna** albo **zajęta**, z ceną za pierwszy rok i za odnowienie.

Jeśli domena jest zajęta, ale należy do Ciebie, kliknij **Twoja? Przenieś do nas** — zobacz [Przeniesienie domeny](../domeny/przeniesienie-domeny).

Ceny wszystkich rozszerzeń znajdziesz w zakładce **Cennik**. Ceny są podane netto za rok.

#### Krok 2. Podaj dane abonenta

Przy wolnej domenie kliknij **Kup**. Abonent to właściciel domeny — osoba albo firma, na którą rejestrujemy domenę. Rejestr domen wymaga jego danych. Jeśli dodajesz abonenta pierwszy raz, formularz pojawi się od razu w oknie zakupu.

1. Wybierz **Osoba prywatna** albo **Firma**.
2. Wypełnij dane:
   - **Imię i nazwisko** (osoba) albo **Nazwa firmy** i **Osoba reprezentująca** (firma),
   - **PESEL** (osoba) albo **NIP** (firma),
   - **E-mail** i **Telefon**, np. `+48 600 100 200`,
   - **Ulica i numer**, **Kod pocztowy** (w formacie `00-000`), **Miasto** i **Kraj**.
3. Kliknij **Zapisz abonenta i przejdź dalej**.

PESEL jest wymagany przez rejestr domen .pl do identyfikacji abonenta i nie jest publikowany. W wyszukiwarce WHOIS domen .pl dane osób prywatnych nie są publiczne.

> **Uwaga:** nazwy, numeru PESEL lub NIP ani e-maila abonenta nie można później zmienić. Zmiana właściciela domeny to osobna procedura (cesja). Telefon i adres zmienisz w zakładce **Abonenci** (ikona ołówka).

Przy kolejnych domenach wybierzesz zapisanego abonenta z listy. Wszystkich abonentów (maksymalnie 20) zobaczysz i dodasz w zakładce **Abonenci**.

#### Krok 3. Zapłać

1. Sprawdź podsumowanie: cenę rejestracji na rok, cenę z VAT i koszt odnowienia.
2. Wybierz abonenta w polu **Abonent (właściciel domeny)**.
3. Kliknij **Kup za … + VAT**.

Jeśli na saldzie brakuje środków, kliknij **Doładuj … + VAT**. Po płatności wrócisz do okna zakupu i dokończysz go jednym kliknięciem.

Rejestracja trwa zwykle kilka minut. Status zobaczysz w zakładce **Moje domeny** („rejestracja w toku…”, potem „zarejestrowana u nas” z datą ważności). Jeśli rejestr nie przyjmie rejestracji, pieniądze wrócą na saldo.

#### Co dalej

Po zakupie panel zaproponuje następny krok:

- **Dodaj stronę dla tej domeny** — jeśli masz już hosting,
- **Zamów hosting dla tej domeny** — jeśli jeszcze go nie masz. Domena zostanie podłączona automatycznie.

Zobacz też [Dodawanie strony](../hosting/dodawanie-strony) i [DNS i rekordy](../domeny/dns-i-rekordy).

#### Odnawianie domeny

Na stronie domeny (zakładka **Moje domeny** → domena), w karcie **Rejestracja domeny**:

- przełącznik **Odnawiaj automatycznie z salda** — 14 dni przed wygaśnięciem pobierzemy opłatę z salda i odnowimy domenę na rok,
- przycisk **Odnów teraz** — przedłuża domenę o rok od razu.

Przypomnienia o wygaśnięciu wysyłamy 30, 7 i 1 dzień przed terminem.

> **Wskazówka:** przy włączonym automatycznym odnawianiu pilnuj, by na saldzie były środki — bez nich domena nie zostanie odnowiona i po terminie wygaśnie.

## Jak przenieść domenę do nas

Adres: https://pomoc.hostava.pl/domeny/przeniesienie-domeny

Transfer domeny od innego rejestratora z kodem authinfo oraz przeniesienie domeny od nas do innego rejestratora.

Przeniesienie (transfer) domeny zmienia rejestratora, u którego opłacasz domenę. Dzięki temu domenę, hosting i pocztę masz w jednym panelu i opłacasz z jednego salda.

#### Zanim zaczniesz

1. U obecnego rejestratora **zdejmij blokadę transferu**, jeśli jest włączona.
2. Pobierz **kod authinfo** (kod transferu) — wygenerujesz go w panelu obecnego rejestratora albo dostaniesz od jego obsługi.
3. Jeśli nie masz jeszcze zapisanego abonenta (właściciela domeny), dodaj go w sekcji **Domeny**, w zakładce **Abonenci** — zobacz [Rejestracja domeny](../domeny/rejestracja-domeny).

> **Uwaga:** dla domen .pl kod authinfo jest ważny 14 dni. Jeśli wygaśnie, poproś obecnego rejestratora o nowy.

#### Transfer krok po kroku

1. W menu bocznym kliknij **Domeny**.
2. Otwórz zakładkę **Przenieś domenę**.
3. W polu **Domena** wpisz nazwę domeny, np. `mojafirma.pl`.
4. W polu **Kod authinfo (kod transferu)** wklej kod od obecnego rejestratora.
5. W polu **Abonent (właściciel domeny)** wybierz abonenta.
6. Kliknij **Przenieś**. Przy przycisku widzisz cenę transferu.

Przed pobraniem opłaty sprawdzamy, czy kod jest poprawny. Jeśli na saldzie brakuje środków, kliknij **Doładuj … + VAT** — po płatności wrócisz do formularza (kod authinfo trzeba wtedy wpisać ponownie).

#### Ile to trwa

Domeny .pl przenoszą się zwykle w kilka minut, inne rozszerzenia — do kilku dni. Status zobaczysz w zakładce **Moje domeny** („transfer w toku…”, potem „przeniesiona do nas”). Jeśli rejestr nie przyjmie transferu, opłata wróci na saldo.

Przeniesienie nie skraca okresu ważności domeny.

#### Strona i poczta podczas transferu

Transfer **nie zmienia serwerów DNS** domeny — strona i poczta działają jak dotąd, u dotychczasowego dostawcy. Jeśli chcesz, aby domena korzystała z naszego DNS (np. bo strona i poczta są już w naszym hostingu):

1. Otwórz domenę w zakładce **Moje domeny**.
2. Jeśli strona lub poczta działały u innego dostawcy, najpierw kliknij **Przepisz rekordy od obecnego dostawcy**.
3. Kliknij **Ustaw nasze serwery nazw** i potwierdź.

Szczegóły znajdziesz w artykule [Serwery nazw](../domeny/serwery-nazw).

#### Po przeniesieniu

Na stronie domeny, w karcie **Rejestracja domeny**, ustawisz **Odnawiaj automatycznie z salda** albo odnowisz domenę ręcznie przyciskiem **Odnów teraz**.

#### Przeniesienie domeny od nas do innego rejestratora

Domenę zarejestrowaną lub przeniesioną do nas możesz w każdej chwili przenieść dalej:

1. Otwórz domenę w zakładce **Moje domeny**.
2. W karcie **Rejestracja domeny**, przy pozycji **Transfer do innego rejestratora**, kliknij **Poproś o kod transferu** i potwierdź.
3. Kod authinfo wyślemy e-mailem właścicielowi konta, zwykle w ciągu 1 dnia roboczego. Gdy będzie gotowy, zobaczysz go też w panelu po kliknięciu **Pokaż kod authinfo**.
4. Podaj kod nowemu rejestratorowi.

Do czasu przeniesienia domena działa bez zmian. Po przeniesieniu jej odnowienia prowadzi nowy rejestrator. Jeśli kod wygaśnie, kliknij **Poproś o nowy kod**.

## Strefa DNS i rekordy

Adres: https://pomoc.hostava.pl/domeny/dns-i-rekordy

Jak dodawać, edytować i usuwać rekordy DNS (A, CNAME, MX, TXT i inne) oraz sprawdzać historię zmian.

Strefa DNS to zestaw rekordów, które mówią internetowi, gdzie działa strona, poczta i inne usługi Twojej domeny. Gdy domena korzysta z naszych serwerów nazw, rekordy edytujesz w panelu.

#### Otwarcie strefy

1. W menu bocznym, w grupie **Strony i poczta**, kliknij **Domeny**.
2. W zakładce **Moje domeny** kliknij domenę.

Na górze strony zobaczysz komunikat o stanie domeny. Zielony oznacza, że domena jest skierowana na nasze serwery nazw i zmiany rekordów działają. Jeśli domena używa innych serwerów nazw, rekordy edytowane tutaj nie będą działać — zobacz [Serwery nazw](../domeny/serwery-nazw).

> **Wskazówka:** strefę z rekordami strony i poczty panel tworzy sam przy dodawaniu strony lub domeny pocztowej. Zwykle nie musisz niczego zmieniać ręcznie.

#### Dodanie rekordu

1. Kliknij **Dodaj rekord**.
2. Wybierz **Typ** rekordu.
3. W polu **Nazwa** wpisz nazwę względem domeny: `@` oznacza samą domenę (np. `moja-firma.pl`), a `sklep` — subdomenę `sklep.moja-firma.pl`.
4. Uzupełnij pola zależne od typu (opis niżej).
5. Ustaw **TTL (sekundy)** — od 60 do 604800. Domyślnie 3600 (godzina). Krótszy TTL oznacza szybsze rozchodzenie się zmian.
6. Kliknij **Zapisz**.

Zmiany są widoczne w internecie zwykle w ciągu kilku minut, maksymalnie po czasie TTL poprzedniej wartości.

#### Najczęstsze rekordy

| Typ | Do czego służy | Co wpisać |
|---|---|---|
| **A** | kieruje nazwę na adres IPv4 serwera | **Adres IPv4**, np. `203.0.113.10` |
| **AAAA** | kieruje nazwę na adres IPv6 | **Adres IPv6** |
| **CNAME** | nazwa jest aliasem innej nazwy | **Wskazuje na (host)**, np. `sklep.platforma.pl` |
| **MX** | serwer przyjmujący pocztę domeny | **Priorytet** (np. `10`) i **Serwer poczty** |
| **TXT** | weryfikacje (Google, Microsoft), SPF, DMARC | **Treść** — bez cudzysłowów |
| **SRV** | usługi, np. komunikatory | **Priorytet**, **Waga**, **Port**, **Host** |
| **CAA** | które urzędy mogą wystawiać certyfikaty | **Flagi**, **Tag**, **Wartość** |
| **NS** | przekazanie subdomeny innym serwerom nazw | **Serwer nazw subdomeny** |

##### Przykład: weryfikacja domeny w Google

Google Search Console poda Ci tekst w stylu `google-site-verification=abc123`. Dodaj rekord **TXT** z nazwą `@` i wklej ten tekst w pole **Treść**.

##### Przykład: subdomena na zewnętrznej platformie

Platforma sklepu podała adres `moj-sklep.platforma.pl`. Dodaj rekord **CNAME** z nazwą `sklep` i wpisz ten adres w pole **Wskazuje na (host)**.

#### Ograniczenia

- **CNAME nie może być w samej domenie** (`@`) — tam użyj rekordu A.
- **CNAME musi być jedynym rekordem** danej nazwy. Jeśli pod nazwą są inne rekordy, najpierw je usuń.
- **Rekordy NS samej domeny i rekord SOA** są oznaczone jako **systemowy** — zarządza nimi panel i nie można ich edytować. Rekord NS dodasz tylko dla subdomeny.

> **Uwaga:** zmiana lub usunięcie rekordów A strony albo MX, SPF i DKIM poczty może wyłączyć stronę lub pocztę. Zmieniaj je tylko wtedy, gdy wiesz, że strona lub poczta działa gdzie indziej.

#### Edycja i usuwanie

Przy każdym rekordzie masz ikony ołówka (edycja) i kosza (usunięcie). Typu rekordu nie można zmienić — usuń rekord i dodaj nowy.

#### Odnów DNS

Przycisk **Odnów DNS** przywraca w strefie rekordy potrzebne do działania hostingu: serwery nazw, SPF, DKIM, DMARC i rekordy automatycznej konfiguracji poczty. Twoje własne rekordy zostają. Użyj go, gdy panel pokazuje, że poczta wymaga uwagi — zobacz [Spam i ochrona poczty](../poczta/spam-i-ochrona-poczty).

#### Historia zmian

Przycisk **Historia zmian** pokazuje, kto i kiedy dodał, zmienił lub usunął rekord — z wartością przed i po zmianie. Przydaje się, gdy coś przestało działać i trzeba odtworzyć poprzednią wartość.

## Serwery nazw — jak skierować domenę do nas

Adres: https://pomoc.hostava.pl/domeny/serwery-nazw

Jak podłączyć do hostingu domenę zarejestrowaną u innego rejestratora i jak zmienić serwery nazw domeny zarejestrowanej u nas.

Serwery nazw (DNS) decydują, gdzie działa strona i poczta domeny. Aby domena korzystała z naszego hostingu, u jej rejestratora muszą być ustawione nasze serwery nazw:

| Serwer nazw | Adres |
|---|---|
| Podstawowy | `ns1.hostava.pl` |
| Zapasowy | `ns2.hostava.pl` |

Adresy znajdziesz też w panelu na stronie **Podsumowanie**, w karcie **Dane dostępowe**.

#### Domena zarejestrowana u nas

Domena kupiona w naszym panelu od razu korzysta z naszych serwerów nazw — nic nie musisz robić.

#### Domena zarejestrowana u innego rejestratora

##### Krok 1. Dodaj domenę do hostingu

Dodaj stronę dla domeny ([Dodawanie strony](../hosting/dodawanie-strony)) albo samą domenę pocztową (**Poczta → Dodaj domenę**). Panel utworzy strefę DNS z rekordami strony i poczty. Domena pojawi się w sekcji **Domeny**.

##### Krok 2. Przepisz rekordy od obecnego dostawcy

Jeśli domena ma już jakieś usługi (np. subdomenę sklepu, weryfikację Google, pocztę w innej firmie), przenieś ich rekordy, zanim zmienisz serwery nazw:

1. W sekcji **Domeny** kliknij domenę.
2. W karcie **Rejestracja domeny** kliknij **Przepisz rekordy od obecnego dostawcy**.
3. Panel pokaże rekordy odczytane z obecnych serwerów nazw z oznaczeniem: **nowy**, **już jest** albo **zastąpi obecny**. Zaznacz te, które chcesz przenieść.
4. Kliknij **Przepisz zaznaczone**.

Panel sprawdza typowe nazwy (domena główna, `www`, `mail`, rekordy DKIM, DMARC i inne). Pozostałe subdomeny dopisz ręcznie — [DNS i rekordy](../domeny/dns-i-rekordy).

> **Uwaga:** jeśli poczta ma działać u nas, nie przepisuj rekordów MX i SPF starego dostawcy.

##### Krok 3. Zmień serwery nazw u rejestratora

1. Zaloguj się do panelu firmy, w której zarejestrowana jest domena.
2. Znajdź ustawienia serwerów nazw (DNS) domeny.
3. Usuń dotychczasowe serwery i wpisz `ns1.hostava.pl` oraz `ns2.hostava.pl`.
4. Zapisz zmiany.

> **Uwaga:** ustaw wyłącznie nasze dwa serwery. Jeśli zostawisz także stare, domena będzie działać niestabilnie — panel pokaże wtedy komunikat, że domena wskazuje częściowo na nasze serwery, a częściowo na inne.

##### Krok 4. Sprawdź stan

Zmiana rozchodzi się zwykle w ciągu kilku godzin (czasem do doby). Otwórz domenę w sekcji **Domeny** — gdy zobaczysz zielony komunikat **Domena jest skierowana na nasze serwery nazw**, wszystko działa. Teraz włącz certyfikat SSL — [Certyfikat SSL](../hosting/certyfikat-ssl).

> **Wskazówka:** domenę możesz też przenieść do nas — wtedy odnawiasz ją w tym samym panelu. Zobacz [Przeniesienie domeny](../domeny/przeniesienie-domeny).

#### Zmiana serwerów nazw domeny zarejestrowanej u nas

Na stronie domeny, w karcie **Rejestracja domeny**, w pozycji **Serwery nazw**:

- **Ustaw nasze serwery nazw** — przełącza domenę na nasz DNS. Za domenę odpowiadają wtedy rekordy ze strefy w panelu.
- **Ustaw własne serwery nazw** — wpisz od 2 do 13 serwerów, każdy w osobnej linii, np. serwery Cloudflare (`anna.ns.cloudflare.com`), i kliknij **Zapisz**.

Zmiana rozchodzi się w ciągu kilku godzin.

> **Uwaga:** po przełączeniu na własne serwery nazw rekordy z naszego panelu przestaną działać. Strona i poczta muszą mieć wtedy rekordy u nowego dostawcy DNS.

#### Domena zostaje przy zewnętrznym DNS

Możesz też nie zmieniać serwerów nazw i dodać potrzebne rekordy u obecnego dostawcy DNS:

- dla strony — rekord **A** z adresem IP strony (widzisz go w szczegółach strony, w zakładce **Podsumowanie**, w pozycji **Adres IP**),
- dla poczty — rekordy MX, SPF, DKIM i DMARC. Panel pokaże je z wartościami do skopiowania w poczcie domeny, w zakładce **Podsumowanie** (karta stanu poczty → **Pokaż szczegóły**).

Zobacz też [Spam i ochrona poczty](../poczta/spam-i-ochrona-poczty).

# Serwery VPS

## Jak utworzyć serwer VPS

Adres: https://pomoc.hostava.pl/serwery/tworzenie-serwera

Krok po kroku przez kreator serwera — lokalizacja, obraz systemu lub aplikacji, plan, logowanie, projekt i opcje sieci.

Serwer VPS to maszyna wirtualna z własnym systemem, do którego masz pełny dostęp (root). Tworzysz go w kilka minut w kreatorze w panelu.

#### Otwórz kreator

1. Zaloguj się do panelu https://cloud.hostava.pl.
2. W menu bocznym, w grupie **Serwery i chmura**, wybierz **Serwery**.
3. Kliknij **Utwórz serwer**.

Kreator ma sześć sekcji. Na dole ekranu cały czas widzisz podsumowanie: wybrany plan, system, lokalizację i cenę.

#### 1. Lokalizacja

Wybierz centrum danych. Pod nazwą lokalizacji widzisz, jakie adresy są dostępne (np. „IPv4 + IPv6”). Lokalizacja oznaczona jako **Brak wolnych zasobów** jest chwilowo niedostępna. Jeśli w lokalizacji zabrakło wolnych adresów IPv4, serwer możesz tam utworzyć tylko bez publicznego IPv4.

#### 2. Obraz

Masz dwie zakładki:

- **Systemy operacyjne** — czysty system, np. Ubuntu, Debian, Rocky Linux, AlmaLinux lub Fedora. Wersję wybierzesz z listy rozwijanej na kafelku.
- **Aplikacje** — system z gotową aplikacją (np. WordPress, Docker, LEMP, Node.js, Uptime Kuma, Coolify, OpenVPN, n8n), która instaluje się sama przy pierwszym starcie. Wybierasz jeszcze **System bazowy**.

Aplikacja ma wymagania co do pamięci RAM, dlatego zbyt małe plany są wtedy nieaktywne. Instalacja trwa kilka minut, a hasła do aplikacji są generowane na serwerze — zobaczysz je po zalogowaniu przez SSH. Instrukcje pojawią się też na karcie **Przegląd** serwera.

#### 3. Plan

Plany są podzielone na kategorie:

- **Standard** — zbalansowane CPU i RAM, dla większości zastosowań,
- **CPU-Optimized** — więcej rdzeni na GB RAM (obliczenia, CI, kompilacja),
- **Memory-Optimized** — dużo pamięci (bazy danych, cache),
- **Storage** — duże dyski (backupy, pliki).

Każdy plan pokazuje liczbę vCPU, RAM, dysk i miesięczny transfer. Płacisz za każdą rozpoczętą godzinę, z góry, ale w miesiącu nigdy więcej niż cena miesięczna planu. Plan możesz później zmienić — zobacz [Zmiana planu serwera](../serwery/zmiana-planu-serwera).

#### 4. Uwierzytelnianie

- **Klucz SSH** (zalecane) — zaznacz jeden lub więcej kluczy albo kliknij **Dodaj nowy klucz SSH**.
- **Hasło root** — panel od razu wygeneruje silne hasło; możesz je zmienić. Hasło musi mieć 8–72 znaki, w tym literę i cyfrę.

> **Uwaga:** Hasło nie jest przechowywane w panelu. Zapisz je przed utworzeniem serwera.

Więcej w artykule [Logowanie przez SSH i klucze](../serwery/logowanie-ssh-i-klucze).

#### 5. Szczegóły

- **Nazwa hosta** — podpowiadana automatycznie; dozwolone są litery, cyfry, myślniki i kropki.
- **Liczba serwerów** — od 1 do 10 identycznych serwerów naraz. Dostaną nazwy z końcówką `-1`, `-2` itd.
- **Projekt** — serwer trafi do sieci prywatnej wybranego projektu (pod polem widzisz jej adresację). Więcej: [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu).
- **Tagi** — etykiety do filtrowania listy serwerów (Enter lub przecinek dodaje tag).
- **Sieć**:
  - **Publiczny IPv4** — domyślnie włączony,
  - **Publiczny IPv6 (bez dopłat)** — jeśli lokalizacja go obsługuje,
  - **Sieć prywatna projektu** — zawsze włączona,
  - **Szyfrowany dysk (at-rest)** — jeśli lokalizacja to oferuje; nie zmienia ceny ani działania serwera.

Gdy wyłączysz publiczny IPv4, panel wyjaśni, jak będzie wyglądał dostęp do serwera (NAT, IPv6 lub tylko sieć prywatna). Szczegóły w artykule [Adresy IP serwera](../serwery/adresy-ip).

#### 6. Cloud-init (opcjonalnie)

Możesz dodać własny skrypt `#cloud-config` lub skrypt bash, który wykona się raz przy pierwszym uruchomieniu — np. instalację Dockera lub Nginxa. Zobacz [Cloud-init i skrypty startowe](../serwery/cloud-init-i-skrypty-startowe).

#### Utwórz serwer

Kliknij **Utwórz serwer** na dole ekranu. Jeśli saldo konta nie wystarcza, zamiast tego zobaczysz przycisk **Doładuj konto**.

Panel przeniesie Cię na stronę serwera. Status zmieni się na „działa” zwykle w mniej niż minutę. Adres IP i gotowe polecenie SSH znajdziesz na karcie **Przegląd**.

> **Wskazówka:** Wyłączony serwer nadal jest rozliczany, bo jego zasoby pozostają zarezerwowane. Aby przestać płacić, usuń serwer na karcie **Usuń**.

## Logowanie przez SSH i klucze SSH

Adres: https://pomoc.hostava.pl/serwery/logowanie-ssh-i-klucze

Jak dodać klucz SSH w panelu i zalogować się na serwer z Linuksa, macOS i Windows (OpenSSH, PuTTY).

Na serwer logujesz się przez SSH. Najbezpieczniej robić to kluczem SSH zamiast hasłem.

#### Klucz czy hasło?

Przy tworzeniu serwera (i przy reinstalacji) wybierasz sposób logowania:

- **Klucz SSH** — zalecany. Serwer akceptuje wtedy logowanie na konto `root` tylko kluczem, a logowanie hasłem przez SSH jest wyłączone.
- **Hasło root** — panel ustawi hasło i włączy logowanie nim przez SSH. Hasła nie przechowujemy, więc zapisz je od razu.

#### Krok 1: wygeneruj klucz

Na Linuksie, macOS i Windows 10/11 (PowerShell) użyj polecenia:

```bash
ssh-keygen -t ed25519 -C "laptop-praca"
```

Zatwierdź domyślną lokalizację pliku i opcjonalnie ustaw hasło do klucza. Powstaną dwa pliki:

- `~/.ssh/id_ed25519` — klucz prywatny, **nigdy go nie udostępniaj**,
- `~/.ssh/id_ed25519.pub` — klucz publiczny, ten wklejasz do panelu.

Wyświetl klucz publiczny:

```bash
cat ~/.ssh/id_ed25519.pub
```

W Windows PowerShell:

```powershell
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
```

#### Krok 2: dodaj klucz w panelu

1. W menu bocznym, w grupie **Dla programistów**, wybierz **Klucze SSH**.
2. Kliknij **Dodaj klucz**.
3. W polu **Klucz publiczny** wklej całą zawartość pliku `.pub` (zaczyna się od `ssh-ed25519` albo `ssh-rsa`).
4. Wpisz **Nazwę**, np. `laptop-praca` — panel podpowie ją z komentarza klucza.
5. Kliknij **Dodaj klucz**.

Klucz możesz też dodać bezpośrednio w kreatorze serwera przyciskiem **Dodaj nowy klucz SSH**.

> **Uwaga:** Klucze z panelu są wgrywane na serwer tylko przy jego tworzeniu lub reinstalacji. Usunięcie klucza w panelu nie usuwa go z istniejących serwerów — zostaje w pliku `/root/.ssh/authorized_keys`, skąd musisz go usunąć ręcznie. Kolejny klucz do działającego serwera również dopisujesz w tym pliku.

#### Krok 3: zaloguj się

Gotowe polecenie znajdziesz na stronie serwera, na karcie **Przegląd**, w sekcji **Logowanie** (z przyciskiem kopiowania), np.:

```bash
ssh root@203.0.113.10
```

Przy pierwszym połączeniu potwierdź odcisk klucza serwera, wpisując `yes`. Jeśli używasz klucza o niestandardowej nazwie, wskaż go:

```bash
ssh -i ~/.ssh/moj_klucz root@203.0.113.10
```

Dla serwera z samym adresem IPv6:

```bash
ssh root@2001:db8::1
```

#### Windows

##### Wbudowany OpenSSH (zalecane)

Windows 10 i 11 mają klienta SSH. Otwórz **PowerShell** lub **Terminal** i użyj tych samych poleceń `ssh-keygen` i `ssh` co powyżej.

##### PuTTY

1. Uruchom **PuTTYgen**, wybierz typ **EdDSA (Ed25519)** i kliknij **Generate**.
2. Skopiuj tekst z pola „Public key for pasting into OpenSSH authorized_keys file” i dodaj go w panelu jako klucz SSH.
3. Kliknij **Save private key** i zapisz plik `.ppk`.
4. W **PuTTY** wpisz adres serwera w polu **Host Name**, port `22`.
5. W **Connection → SSH → Auth → Credentials** wskaż plik `.ppk`.
6. Kliknij **Open** i zaloguj się jako `root`.

#### Serwer bez publicznego adresu

Jeśli serwer nie ma publicznego IPv4 ani IPv6, połączysz się z nim przez sieć prywatną projektu — z innego serwera w tym samym projekcie albo przez VPN — lub przez [konsolę w przeglądarce](../serwery/konsola-w-przegladarce).

#### Nie mogę się połączyć

- Sprawdź, czy [zapora sieciowa](../serwery/zapora-sieciowa) ma regułę otwierającą port 22 (TCP).
- Upewnij się, że serwer działa (karta **Zasilanie**).
- Gdy SSH nie odpowiada, zaloguj się przez [konsolę w przeglądarce](../serwery/konsola-w-przegladarce) i sprawdź konfigurację.
- Jeśli zgubiłeś klucz prywatny, a serwer nie ma hasła, możesz wykonać reinstalację z nowym kluczem (karta **Reinstalacja**) — usuwa ona jednak wszystkie dane z dysku.

## Konsola serwera w przeglądarce

Adres: https://pomoc.hostava.pl/serwery/konsola-w-przegladarce

Jak otworzyć konsolę VNC serwera w przeglądarce i zalogować się, gdy SSH lub sieć nie działają.

Konsola daje bezpośredni dostęp do ekranu serwera — tak jakbyś podłączył monitor i klawiaturę. Działa nawet wtedy, gdy sieć lub SSH są niedostępne, np. po błędnej konfiguracji zapory lub sieci.

#### Jak otworzyć konsolę

1. Wejdź w **Serwery** i otwórz wybrany serwer.
2. Kliknij przycisk **Konsola** w nagłówku strony albo przejdź na kartę **Konsola** i kliknij **Otwórz konsolę**.
3. Konsola otworzy się w osobnym oknie przeglądarki.

> **Uwaga:** Serwer musi być uruchomiony, a na serwerze nie może trwać inna operacja (np. reinstalacja czy zmiana planu). W przeciwnym razie przycisk jest nieaktywny.

Jeśli przeglądarka zablokuje wyskakujące okno, zezwól na okna dla strony panelu i kliknij przycisk ponownie.

#### Pasek narzędzi konsoli

U góry okna znajdziesz:

- kolorową kropkę stanu — zielona oznacza połączenie, żółta łączenie, czerwona rozłączenie,
- **Ctrl+Alt+Del** — wysyła tę kombinację do serwera,
- **Wklej tekst** — wpisuje do konsoli tekst ze schowka, znak po znaku (przydatne przy długich poleceniach),
- **Pełny ekran**,
- **Połącz ponownie** — gdy połączenie zostało przerwane.

#### Logowanie w konsoli

Konsola pokazuje zwykły ekran logowania systemu. Zaloguj się jako `root` **hasłem**.

> **Wskazówka:** Jeśli serwer utworzyłeś z kluczem SSH, konto `root` nie ma hasła i w konsoli się nie zalogujesz. Zawczasu, przez SSH, ustaw hasło poleceniem `passwd` — wtedy konsola posłuży jako dostęp awaryjny. Ustawienie hasła nie włącza logowania hasłem przez SSH.

```bash
passwd
```

#### Kiedy używać konsoli

- Zapora blokuje port 22 i nie możesz się połączyć przez SSH — zaloguj się w konsoli albo popraw reguły w zakładce **Firewall** (zobacz [Zapora sieciowa](../serwery/zapora-sieciowa)).
- Po zmianie konfiguracji sieci serwer stracił łączność.
- Serwer nie ma publicznego adresu IP, a nie masz innego serwera ani VPN w sieci prywatnej projektu.
- Chcesz zobaczyć komunikaty startu systemu, np. gdy serwer nie uruchamia się poprawnie.

#### Gdy konsola się nie łączy

- Kliknij **Połącz ponownie** — dostęp do konsoli jest przyznawany na krótko i po dłuższej przerwie trzeba go odnowić.
- Sprawdź na karcie **Zasilanie**, czy serwer działa.
- Jeśli system się zawiesił, użyj na karcie **Zasilanie** opcji **Reset** (twardy reset) lub **Wymuś wyłączenie**, a potem **Uruchom**.
- Zamknij okno konsoli i otwórz je ponownie z panelu.

Każde otwarcie konsoli jest zapisywane w historii aktywności konta.

## Zapora sieciowa (firewall) serwera

Adres: https://pomoc.hostava.pl/serwery/zapora-sieciowa

Jak włączyć firewall serwera w panelu i dodać reguły dla wybranych portów, protokołów i adresów źródłowych.

Każdy serwer ma firewall, którym sterujesz w panelu. Działa on przed systemem serwera, więc nie musisz konfigurować `iptables` ani `ufw` (choć możesz — oba poziomy działają niezależnie).

#### Jak działa firewall

- **Wyłączony** (domyślnie) — wszystkie porty publicznych adresów są dostępne z Internetu.
- **Włączony** — ruch przychodzący na publiczne adresy jest blokowany, poza ruchem dopuszczonym przez Twoje reguły.
- Ruch wychodzący z serwera jest zawsze dozwolony, a odpowiedzi na połączenia wychodzące przechodzą automatycznie.
- Sieć prywatna projektu nie jest filtrowana — serwery w projekcie komunikują się bez ograniczeń.

Niezależnie od ustawień zawsze działa **ochrona sieci**: serwer może wysyłać ruch wyłącznie ze swoich adresów IP i MAC (ochrona przed podszywaniem się).

#### Włączanie i dodawanie reguł

1. Otwórz serwer i przejdź na kartę **Firewall**.
2. Przestaw przełącznik w prawym górnym rogu na **Włączony**. Panel od razu doda regułę dla SSH (port 22), żeby nie odciąć Ci dostępu.
3. Dodaj reguły:
   - przyciskiem **Reguła** — pusta reguła do uzupełnienia,
   - przyciskami szybkimi: **+ SSH**, **+ HTTP**, **+ HTTPS**, **+ Ping**, **+ MySQL**, **+ PostgreSQL**, **+ WireGuard**.
4. Kliknij **Zapisz i zastosuj**.

Zmiany zaczynają działać po kilku sekundach. W prawym dolnym rogu widzisz datę ostatniego zastosowania. Jeśli na serwerze trwa inna operacja, reguły zostaną zastosowane po jej zakończeniu. Przycisk **Odrzuć zmiany** przywraca zapisany stan.

#### Pola reguły

| Pole | Opis |
|---|---|
| **Protokół** | TCP, UDP, ICMP (ping) albo Wszystkie |
| **Porty** | Tylko dla TCP i UDP: pojedynczy port (`22`), lista (`80,443`) lub zakres (`8000:8100`). Maksymalnie 10 pozycji w jednej regule. |
| **Źródło** | Adres lub sieć IPv4/IPv6, np. `203.0.113.7` albo `203.0.113.0/24`. Puste pole = dowolny adres. |
| **Opis** | Własna notatka, do 60 znaków. |

Na jednym serwerze możesz mieć do 50 reguł. Reguła ICMP obejmuje ping zarówno po IPv4, jak i IPv6.

#### Przykład: serwer WWW z SSH tylko z biura

| Protokół | Porty | Źródło | Opis |
|---|---|---|---|
| TCP | 22 | 198.51.100.20 | SSH z biura |
| TCP | 80,443 | *(puste)* | WWW |
| ICMP | — | *(puste)* | Ping |

> **Uwaga:** Jeśli żadna reguła nie otwiera portu 22, panel wyświetli ostrzeżenie — nie połączysz się wtedy przez SSH. Dostęp awaryjny zostaje przez [konsolę w przeglądarce](../serwery/konsola-w-przegladarce), a reguły zawsze poprawisz w panelu.

> **Uwaga:** Włączony firewall bez żadnej reguły blokuje cały ruch przychodzący.

#### Poczta wychodząca (port 25)

Ze względów antyspamowych wysyłanie poczty bezpośrednio na port 25 innych serwerów jest domyślnie zablokowane — niezależnie od ustawień firewalla. Jeśli potrzebujesz własnego serwera pocztowego, skontaktuj się z pomocą techniczną przez zgłoszenie. Do wysyłki przez zewnętrzny serwer SMTP używaj portów 587 lub 465 — nie są blokowane.

#### Wskazówki

- Otwieraj tylko porty, z których faktycznie korzystasz.
- Dostęp do bazy danych czy panelu administracyjnego ogranicz polem **Źródło** do znanych adresów.
- Do komunikacji między własnymi serwerami używaj adresów prywatnych z [sieci prywatnej projektu](../projekty-i-sieci/siec-prywatna-projektu) — nie wymaga to żadnych reguł.
- Na karcie **Przegląd** widać, czy firewall jest włączony (etykieta „Firewall: włączony”), a nazwa karty **Firewall** ma wtedy zieloną kropkę.

## Kopie zapasowe i migawki serwera

Adres: https://pomoc.hostava.pl/serwery/kopie-i-migawki

Jak włączyć backup serwera — migawki co godzinę i pełne kopie w osobnym magazynie — ustawić harmonogram i przywrócić serwer.

Backup serwera łączy dwa rodzaje kopii:

- **Migawki co godzinę** — przechowywane 7 dni, pozwalają szybko cofnąć serwer do stanu sprzed np. nieudanej aktualizacji.
- **Pełna kopia poza serwerem** — kopia całego serwera zapisywana w osobnym magazynie danych (S3). Przeżywa awarię sprzętu. Domyślnie wykonywana codziennie.

#### Włączanie backupu

1. Otwórz serwer i przejdź na kartę **Kopie**.
2. Kliknij **Włącz backup**.

Pierwsza migawka powstanie w ciągu godziny. Gdy backup jest włączony, nazwa karty **Kopie** ma zieloną kropkę.

Płacisz za faktyczną zajętość kopii — cena za GB na miesiąc jest widoczna na karcie, a rozliczenie jest godzinowe. Nad listą kopii panel pokazuje bieżącą zajętość i szacowany koszt miesięczny.

#### Harmonogram pełnych kopii

Nad listą kopii, w opisie, znajduje się lista rozwijana z częstotliwością pełnej kopii:

- codziennie,
- co 2 dni,
- co 3 dni,
- co tydzień,
- co 2 tygodnie.

Panel automatycznie dobiera liczbę przechowywanych pełnych kopii tak, by obejmowały około tygodnia wstecz (zawsze co najmniej 2). Liczba przechowywanych kopii jest widoczna obok harmonogramu. Tam też zobaczysz, kiedy powstała ostatnia migawka i ostatnia pełna kopia.

#### Kopia na żądanie

W prawym górnym rogu karty masz dwa przyciski:

- **Migawka teraz** — natychmiastowa migawka. Działa tylko dla uruchomionego serwera.
- **Pełna kopia teraz** — zleca pełną kopię poza serwerem. Rozpocznie się w ciągu minuty i potrwa od kilku minut do około godziny. Do czasu zakończenia przycisk pokazuje **Pełna kopia w toku…**.

Ręczne migawki są oznaczone etykietą **ręczna** i nie są usuwane automatycznie — usuwasz je sam ikoną kosza. Automatyczne migawki starsze niż 7 dni są kasowane same.

> **Wskazówka:** Przed dużą zmianą (aktualizacja systemu, migracja aplikacji) zrób **Migawkę teraz**. Jeśli coś pójdzie nie tak, przywrócisz serwer w kilka minut.

#### Przywracanie z migawki

1. Na karcie **Kopie** znajdź migawkę z odpowiednią datą.
2. Kliknij **Przywróć**.
3. Wpisz nazwę hosta serwera, aby potwierdzić, i kliknij **Przywróć**.

Serwer zostanie cofnięty do stanu z chwili migawki i uruchomiony ponownie.

> **Uwaga:** Wszystkie zmiany zapisane na dysku po utworzeniu migawki przepadną. Jeśli potrzebujesz pojedynczych plików z nowszego stanu, najpierw skopiuj je z serwera.

Przycisk **Przywróć** jest dostępny dla migawek. Pełne kopie poza serwerem służą do odtworzenia serwera po awarii sprzętu — jeśli potrzebujesz odtworzenia z pełnej kopii, napisz zgłoszenie do pomocy technicznej.

#### Wyłączanie backupu

Kliknij **Wyłącz backup** w prawym górnym rogu karty **Kopie**. Nowe kopie przestaną powstawać.

#### Czego backup nie zastępuje

- Migawka obejmuje cały dysk, więc baza danych zostanie przywrócona w stanie z chwili migawki. Dla ważnych baz rozważ [zarządzane bazy danych](../bazy-danych/zarzadzane-bazy-danych) z własnymi kopiami.
- Własne kopie plików możesz dodatkowo wysyłać do [magazynu S3](../chmura/magazyn-s3), np. narzędziem `rclone`.

## Zmiana planu serwera (resize)

Adres: https://pomoc.hostava.pl/serwery/zmiana-planu-serwera

Jak zwiększyć lub zmienić CPU, RAM i dysk serwera bez utraty danych i dlaczego dysku nie można zmniejszyć.

Plan serwera (liczbę vCPU, RAM i rozmiar dysku) zmieniasz w panelu na tym samym serwerze. Dane, adresy IP i konfiguracja zostają bez zmian — nie trzeba tworzyć serwera od nowa.

#### Zasady

- **Zmiana wymaga restartu serwera.** Na czas zmiany serwer jest zatrzymywany i uruchamiany ponownie.
- **Dysk może tylko rosnąć.** Plany z mniejszym dyskiem niż obecny są na liście nieaktywne i oznaczone „(dysk mniejszy — niedostępne)”.
- CPU i RAM możesz zarówno zwiększyć, jak i zmniejszyć — pod warunkiem, że nowy plan ma dysk co najmniej tak duży jak obecny.
- **Cena** przechodzi na nowy plan od kolejnego naliczenia.
- Przy przejściu na droższy plan na koncie musi być saldo co najmniej na godzinę pracy w nowym planie.

#### Jak zmienić plan

1. Otwórz serwer i przejdź na kartę **Ustawienia**.
2. W sekcji **Zmień plan (resize)** sprawdź obecny plan.
3. Z listy **Nowy plan** wybierz plan. Przy każdym widzisz vCPU, RAM, dysk i cenę miesięczną.
4. Kliknij **Zmień plan**.

Panel pokaże komunikat „Zmiana planu rozpoczęta — serwer zostanie zrestartowany”. Postęp widzisz w statusie serwera, a wynik na karcie **Historia**. Zmiana trwa zwykle kilka minut.

> **Wskazówka:** Przed zmianą planu zamknij system poprawnie przyciskiem **Wyłącz** (karta **Zasilanie**) albo poleceniem `shutdown -h now`. Zmiana planu działającego serwera zatrzymuje go bez łagodnego zamykania systemu, co przy aktywnej bazie danych może skończyć się jej odzyskiwaniem po starcie. Jeśli serwer był wyłączony, po zmianie planu pozostanie wyłączony — uruchom go przyciskiem **Uruchom**.

#### Większy dysk

Gdy nowy plan ma większy dysk, panel poinformuje, że „dysk urośnie do … GB”. System sam rozszerzy partycję główną przy kolejnym starcie. Sprawdzisz to poleceniem:

```bash
df -h /
```

Jeśli korzystasz z niestandardowego układu partycji (np. własne LVM utworzone ręcznie), może być konieczne ręczne rozszerzenie wolumenu.

#### Dlaczego dysku nie można zmniejszyć?

Zmniejszenie dysku groziłoby utratą danych zapisanych na jego końcu, dlatego nie jest możliwe. Jeśli potrzebujesz mniejszego dysku:

1. Utwórz nowy serwer z mniejszym planem ([Jak utworzyć serwer](../serwery/tworzenie-serwera)).
2. Przenieś dane, np. przez `rsync` w [sieci prywatnej projektu](../projekty-i-sieci/siec-prywatna-projektu):

```bash
rsync -aHAX --progress /var/www/ root@10.0.0.5:/var/www/
```

3. Usuń stary serwer.

#### Gdy zmiana się nie udała

- „Niewystarczające środki na wyższy plan” — doładuj konto w **Rozliczeniach** i spróbuj ponownie.
- „Serwer jest zawieszony” — najpierw uzupełnij saldo.
- „Na serwerze trwa operacja” — poczekaj na zakończenie bieżącej operacji (np. migawki lub reinstalacji).

Jeśli po zmianie serwer pokazuje błąd, napisz zgłoszenie do pomocy technicznej.

## Adresy IP serwera — IPv4, IPv6, dodatkowe adresy i NAT

Adres: https://pomoc.hostava.pl/serwery/adresy-ip

Jakie adresy może mieć serwer, jak dokupić dodatkowy adres IP i jak działa serwer bez publicznego IPv4 (NAT).

Serwer może mieć adresy publiczne (IPv4 i IPv6) oraz zawsze ma adres w sieci prywatnej projektu. Wszystkie adresy zobaczysz na karcie **Sieć** serwera.

#### Karta Sieć

**Sieć publiczna** pokazuje:

- **IPv4** — publiczny adres IPv4 lub „brak”,
- **IPv6** — publiczny adres IPv6 (z prefiksem `/64`) lub „brak”,
- **Interfejs** — publiczne adresy są na interfejsie `eth0`,
- **NAT (wychodzący)** — tylko dla serwerów bez publicznego IPv4 korzystających z NAT,
- **Transfer** — miesięczny limit transferu z planu.

**Sieć prywatna projektu** pokazuje adres prywatny (interfejs `eth1`) i projekt. Serwery w tym samym projekcie komunikują się bezpośrednio, bez opłat za transfer. Więcej: [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu).

#### Wybór adresów przy tworzeniu serwera

W kreatorze, w sekcji **Szczegóły → Sieć**:

- **Publiczny IPv4** — domyślnie włączony,
- **Publiczny IPv6 (bez dopłat)** — jeśli lokalizacja go obsługuje.

> **Uwaga:** Adresy publiczne wybierasz przy tworzeniu serwera. Panel nie pozwala dodać głównego adresu IPv4 lub IPv6 do już istniejącego serwera — trzeba wtedy utworzyć nowy serwer. Możesz natomiast dokupić dodatkowe adresy IPv4 (poniżej).

Niektóre aplikacje (np. OpenVPN) wymagają publicznego IPv4 — kreator włączy go wtedy sam.

#### Serwer bez publicznego IPv4

Wyłączenie publicznego IPv4 ma sens dla serwerów wewnętrznych: baz, workerów, serwerów aplikacji za [load balancerem](../chmura/load-balancer). Dostęp zależy od lokalizacji i opcji:

- **NAT** (jeśli lokalizacja go oferuje) — serwer ma dostęp do Internetu tylko w ruchu wychodzącym: aktualizacje, instalacja pakietów, wywołania API. Ruch wychodzi ze wspólnego adresu NAT widocznego na karcie **Sieć**. Połączenia przychodzące z Internetu nie docierają.
- **Tylko IPv6** — serwer jest dostępny z Internetu wyłącznie przez IPv6. Usługi dostępne tylko po IPv4 (np. część repozytoriów i API) mogą być nieosiągalne.
- **Bez publicznego adresu i bez NAT** — brak dostępu do Internetu, także aktualizacji.

W każdym z tych przypadków połączysz się z serwerem:

- z innego serwera w tym samym projekcie (jako „bastion”),
- przez VPN do sieci prywatnej projektu — zobacz [VPN dla firm](../chmura/vpn-dla-firm),
- przez [konsolę w przeglądarce](../serwery/konsola-w-przegladarce).

Przykład połączenia przez serwer pośredniczący z publicznym adresem:

```bash
ssh -J root@203.0.113.10 root@10.0.0.5
```

> **Wskazówka:** Z NAT nie wysyła się poczty na port 25 — ruch SMTP jest blokowany.

#### Dodatkowe adresy IP

Do serwera możesz dokupić dodatkowe publiczne adresy IPv4.

1. Otwórz kartę **Sieć**.
2. W sekcji **Dodatkowe adresy IP** kliknij **Dokup adres** (przycisk pokazuje cenę miesięczną).
3. **Zrestartuj serwer** (karta **Zasilanie → Restart**). Każdy adres to osobny interfejs sieciowy i zacznie działać dopiero po restarcie — system skonfiguruje go automatycznie.

Na serwer możesz dokupić do 6 dodatkowych adresów (licznik widać pod tabelą). Koszt adresu jest doliczany do ceny serwera. Jeśli w lokalizacji chwilowo brak wolnych adresów, przycisk nie będzie dostępny.

Aby usunąć adres, kliknij ikonę kosza przy adresie i potwierdź. Adres przestaje być naliczany od razu, a interfejs zniknie po restarcie serwera.

> **Uwaga:** Usunięty adres wraca do puli i może trafić do innego klienta. Przed usunięciem przenieś z niego rekordy DNS.

#### Adres prywatny przy zmianie projektu

Przeniesienie serwera do innego projektu (karta **Ustawienia → Projekt**) zmienia sieć prywatną i adres prywatny. Nowy adres zostanie skonfigurowany po restarcie serwera. Adresy publiczne się nie zmieniają.

#### Usunięcie serwera

Po usunięciu serwera jego adresy IP są zwalniane. Nie da się ich później odzyskać.

## Cloud-init i skrypty startowe

Adres: https://pomoc.hostava.pl/serwery/cloud-init-i-skrypty-startowe

Jak automatycznie skonfigurować serwer przy pierwszym uruchomieniu za pomocą #cloud-config lub skryptu bash.

Cloud-init pozwala automatycznie skonfigurować serwer przy pierwszym uruchomieniu: zainstalować pakiety, utworzyć pliki czy uruchomić polecenia. Dzięki temu nowy serwer jest od razu gotowy do pracy.

#### Gdzie dodać cloud-init

- **Przy tworzeniu serwera** — w kreatorze, w sekcji **6. Cloud-init (opcjonalnie)**, kliknij **+ Dodaj własny cloud-init**.
- **Przy reinstalacji** — na karcie **Reinstalacja**, w polu **Cloud-init po reinstalacji**. Pole jest wypełnione treścią użytą wcześniej, więc możesz ją poprawić.

Na karcie **Przegląd** serwer z własnym cloud-init ma etykietę **własny cloud-init**.

> **Uwaga:** Cloud-init wykonuje się **raz**, przy pierwszym uruchomieniu systemu, z uprawnieniami root. Zmiana treści dla istniejącego serwera jest możliwa tylko przez reinstalację, która usuwa dane z dysku.

#### Dwa formaty

Treść musi zaczynać się od jednego z nagłówków:

- `#cloud-config` — konfiguracja w formacie YAML,
- `#!` — skrypt, np. `#!/bin/bash`.

Maksymalny rozmiar to 64 KB. Panel sprawdza treść na bieżąco i pod polem pokazuje „Cloud-config poprawny” albo „Skrypt poprawny”, a przy błędzie — opis problemu, np. błąd składni YAML z numerem linii. Z błędną treścią nie utworzysz serwera.

#### Gotowe szablony

Nad polem edycji są przyciski **Szablony**: **Docker**, **Nginx**, **Aktualizacje + strefa czasowa** i **Skrypt bash**. Kliknięcie wstawia przykład, który możesz edytować. **Wyczyść** usuwa treść.

#### Przykład: #cloud-config

```yaml
#cloud-config
package_upgrade: true
timezone: Europe/Warsaw
packages:
  - nginx
  - git
write_files:
  - path: /var/www/html/index.html
    content: |
      <h1>Działa!</h1>
runcmd:
  - systemctl enable --now nginx
```

Najczęściej używane klucze:

- `packages` — lista pakietów do instalacji,
- `package_upgrade: true` — aktualizacja systemu,
- `write_files` — tworzenie plików,
- `runcmd` — polecenia wykonywane na końcu konfiguracji,
- `timezone` — strefa czasowa.

#### Przykład: skrypt bash

```bash
#!/bin/bash
set -e
curl -fsSL https://get.docker.com | sh
systemctl enable --now docker
echo "Serwer uruchomiony $(date)" > /root/pierwszy-start.txt
```

#### Co ustawia panel, a co Ty

Panel sam konfiguruje nazwę hosta, hasło root lub klucze SSH oraz sieć. Twój cloud-init jest dołączany do tej konfiguracji — Twoje listy `packages`, `runcmd` i `write_files` są dopisywane, ale nie nadpiszą ustawień tożsamości serwera. Nie musisz więc dodawać kluczy SSH w cloud-init.

#### Sprawdzanie wyniku

Konfiguracja może trwać kilka minut po starcie serwera. Zaloguj się przez SSH i sprawdź:

```bash
cloud-init status --wait
```

Szczegółowy log znajdziesz w plikach:

```bash
less /var/log/cloud-init-output.log
less /var/log/cloud-init.log
```

> **Wskazówka:** Jeśli skrypt nie zadziałał, przetestuj polecenia ręcznie na serwerze, a gotową wersję użyj przy kolejnym serwerze. Gdy instalacja pakietów się nie powiodła, upewnij się, że serwer ma dostęp do Internetu (publiczny adres lub NAT) — zobacz [Adresy IP serwera](../serwery/adresy-ip).

#### Gotowe aplikacje

Jeśli potrzebujesz popularnej aplikacji (np. WordPress, Docker, n8n), zamiast pisać cloud-init wybierz ją w kreatorze w zakładce **Aplikacje** — zobacz [Jak utworzyć serwer](../serwery/tworzenie-serwera).

# Projekty i sieci prywatne

## Czym są projekty

Adres: https://pomoc.hostava.pl/projekty-i-sieci/czym-sa-projekty

Projekty grupują serwery i usługi chmurowe, dają im wspólną sieć prywatną i pozwalają rozdzielić środowiska oraz dostęp zespołu.

Projekt to grupa zasobów w chmurze — serwerów VPS, baz danych, load balancerów, klastrów Kubernetes, RabbitMQ i aplikacji. Każdy projekt ma **własną, izolowaną sieć prywatną**, przez którą jego zasoby łączą się ze sobą.

Projekty pomagają:

- **rozdzielić środowiska** — np. osobny projekt na produkcję i na testy,
- **odizolować sieci** — serwery z różnych projektów nie widzą się w sieci prywatnej,
- **kontrolować koszty** — na stronie projektu widzisz łączny miesięczny koszt jego zasobów,
- **nadawać dostęp** — współpracownika możesz ograniczyć do jednego projektu.

#### Projekt domyślny

Przy zakładaniu konta tworzymy projekt **Mój projekt** oznaczony jako **domyślny**. Trafiają do niego nowe zasoby, jeśli nie wybierzesz innego projektu. Projektu domyślnego nie można usunąć, ale możesz uczynić domyślnym inny projekt.

#### Jak utworzyć projekt

1. Kliknij **+** obok nagłówka **Projekty** w menu (albo **Utwórz → Projekt**).
2. Podaj **Nazwę** i opcjonalnie **Opis**.
3. Wybierz **Środowisko**: **Development**, **Staging** albo **Produkcja**.
4. Kliknij **Utwórz projekt**.

Panel od razu przydziela projektowi sieć prywatną i pokazuje jej adres, np. `10.131.232.0/24`. Środowisko widać jako kolorowy znacznik w menu: czerwony — produkcja, żółty — staging, niebieski — development.

Na jednym koncie możesz mieć do **50 projektów**.

#### Strona projektu

Kliknij projekt w menu. Zobaczysz:

- **Zasoby** — liczbę i listę wszystkich zasobów z typem i statusem,
- **Koszt projektu** — miesięczny koszt netto (bez opłat zależnych od zużycia, np. za storage, transfer czy kopie),
- **Sieć prywatna** — adres sieci projektu.

Przyciski na stronie projektu:

| Przycisk | Działanie |
|---|---|
| **Edytuj** | Zmiana nazwy, opisu i środowiska |
| **Dodaj serwer** | Kreator serwera z tym projektem już wybranym |
| **Ustaw jako domyślny** | Nowe zasoby będą domyślnie trafiać tutaj |
| **Usuń projekt** | Usuwa pusty projekt i jego sieć prywatną |

#### Dodawanie zasobów do projektu

Projekt wybierasz podczas tworzenia serwera, bazy danych, klastra czy aplikacji. Zasób automatycznie trafia do sieci prywatnej projektu i dostaje w niej adres.

#### Przenoszenie serwera do innego projektu

1. Otwórz serwer i przejdź do zakładki **Ustawienia**.
2. W karcie **Projekt** wybierz nowy projekt z listy **Przenieś do projektu**.
3. Kliknij **Przenieś**.

> **Uwaga:** Po przeniesieniu serwer dostaje **nowy adres prywatny** z sieci nowego projektu i traci łączność prywatną z serwerami w starym projekcie. Nowy adres zostanie skonfigurowany po restarcie serwera. Szczegóły w artykule [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu).

#### Usuwanie projektu

Projekt możesz usunąć tylko wtedy, gdy jest pusty. Najpierw przenieś lub usuń jego zasoby, potem kliknij **Usuń projekt** i potwierdź. Razem z projektem usuwana jest jego sieć prywatna.

Powiązane artykuły:

- [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu)
- [Serwery bez publicznego IPv4 i NAT](../projekty-i-sieci/nat-i-serwery-bez-publicznego-ip)
- [Zespół i role](../konto-i-rozliczenia/zespol-i-role)

## Sieć prywatna projektu

Adres: https://pomoc.hostava.pl/projekty-i-sieci/siec-prywatna-projektu

Każdy projekt ma własną, izolowaną sieć prywatną — jak działa, jakie adresy dostają serwery i co się dzieje przy przenoszeniu między projektami.

Każdy projekt dostaje własną **sieć prywatną** — wydzieloną sieć lokalną, w której zasoby projektu widzą się nawzajem. Ruch w tej sieci nie wychodzi do Internetu i jest odizolowany od innych projektów oraz innych klientów.

#### Jak to działa

- Projekt ma podsieć `/24` z puli `10.x.x.x`, np. `10.131.232.0/24`. Adres sieci widzisz na stronie projektu w karcie **Sieć prywatna**.
- Każdy serwer w projekcie dostaje w tej sieci **adres prywatny** z zakresu `.2`–`.254`. Adres `.1` jest zarezerwowany.
- W systemie serwera sieć prywatna to interfejs `eth1`. Interfejs publiczny (jeśli serwer ma publiczny adres) to `eth0`.
- W jednym projekcie zmieści się do **253** serwerów.
- Komunikacja przez sieć prywatną jest **bez opłat za transfer**.

Do sieci prywatnej projektu trafiają automatycznie serwery VPS, zarządzane bazy danych, load balancery, węzły Kubernetes, RabbitMQ i repliki aplikacji utworzone w tym projekcie.

> **Wskazówka:** Bazę danych i inne usługi wewnętrzne łącz po adresie prywatnym. Dzięki temu nie musisz wystawiać ich do Internetu, a ruch nie liczy się do transferu.

#### Gdzie sprawdzić adres prywatny

1. Otwórz serwer i przejdź do zakładki **Sieć**.
2. Karta **Sieć prywatna projektu** pokazuje **Adres prywatny**, interfejs `eth1` i nazwę projektu.

Adres możesz skopiować przyciskiem obok.

#### Izolacja między projektami

Serwery z **różnych** projektów nie widzą się w sieci prywatnej — także wtedy, gdy należą do tego samego konta. Jeśli dwa serwery mają się komunikować prywatnie, umieść je w jednym projekcie.

Przykładowy podział:

| Projekt | Środowisko | Zasoby |
|---|---|---|
| Sklep — produkcja | Produkcja | 2 serwery aplikacji, baza danych, load balancer |
| Sklep — testy | Staging | 1 serwer, baza testowa |

Serwery testowe nie mają wtedy żadnego dostępu sieciowego do produkcyjnej bazy.

#### Przeniesienie serwera do innego projektu

Serwer przeniesiesz w zakładce **Ustawienia** → karta **Projekt** → **Przenieś do projektu** → **Przenieś**.

Co się dzieje po przeniesieniu:

1. Serwer zostaje podłączony do sieci prywatnej nowego projektu.
2. Dostaje **nowy adres prywatny** z podsieci nowego projektu — stary adres przestaje być jego.
3. Traci łączność prywatną z serwerami w poprzednim projekcie.
4. Nowy adres prywatny zostanie skonfigurowany w systemie **po restarcie serwera**.

> **Uwaga:** Zanim przeniesiesz serwer, sprawdź, czy inne usługi nie łączą się z nim po starym adresie prywatnym (np. konfiguracja aplikacji, reguły zapory, load balancer). Po przeniesieniu zaktualizuj te ustawienia i zrestartuj serwer w zakładce **Zasilanie**.

Publiczne adresy IPv4 i IPv6 serwera nie zmieniają się przy przenoszeniu.

#### Dostęp do sieci prywatnej z zewnątrz

Sieć prywatna nie jest dostępna bezpośrednio z Internetu. Aby połączyć się z serwerem, który ma tylko adres prywatny:

- zaloguj się przez SSH na inny serwer w projekcie z publicznym adresem (tzw. bastion) i stamtąd połącz się po adresie prywatnym,
- skorzystaj z [VPN](../chmura/vpn-dla-firm), aby Twój komputer znalazł się w sieci prywatnej projektu,
- użyj konsoli w przeglądarce w panelu serwera.

Powiązane artykuły:

- [Czym są projekty](../projekty-i-sieci/czym-sa-projekty)
- [Serwery bez publicznego IPv4 i NAT](../projekty-i-sieci/nat-i-serwery-bez-publicznego-ip)
- [Jak utworzyć serwer VPS](../serwery/tworzenie-serwera)

## Serwery bez publicznego IPv4 i NAT

Adres: https://pomoc.hostava.pl/projekty-i-sieci/nat-i-serwery-bez-publicznego-ip

Jak działa serwer bez publicznego adresu IPv4, czym jest NAT dla ruchu wychodzącego i jak połączyć się z takim serwerem.

Nie każdy serwer potrzebuje publicznego adresu IPv4. Serwery robocze, bazy danych czy węzły obliczeniowe zwykle wystarczy mieć w [sieci prywatnej projektu](../projekty-i-sieci/siec-prywatna-projektu). Taki serwer jest lepiej chroniony, bo nikt z Internetu nie może się do niego bezpośrednio połączyć.

#### Jak utworzyć serwer bez publicznego IPv4

1. Kliknij **Utwórz → Serwer VPS**.
2. W sekcji sieci wyłącz przełącznik **Publiczny IPv4**.
3. Panel pokaże pod spodem, jak będzie działał dostęp do Internetu w wybranej lokalizacji.
4. Dokończ tworzenie serwera.

> **Wskazówka:** Jeśli w wybranej lokalizacji chwilowo nie ma wolnych adresów IPv4, serwer można utworzyć tylko bez IPv4. Niektóre aplikacje z listy wymagają publicznego adresu — wtedy kreator nie pozwoli go wyłączyć.

#### NAT — Internet tylko w jedną stronę

W lokalizacjach z obsługą NAT serwer bez publicznego IPv4 ma dostęp do Internetu przez **NAT**:

| Działa | Nie działa |
|---|---|
| Aktualizacje systemu i instalacja pakietów | Połączenia przychodzące z Internetu |
| Pobieranie plików, obrazów Docker, repozytoriów Git | Wystawienie strony lub usługi pod adresem NAT |
| Wywołania zewnętrznych API | Wysyłka poczty bezpośrednio na port `25` (SMTP) |

Ruch wychodzący z serwera trafia do Internetu z **adresu NAT**, wspólnego dla wielu serwerów. Ten adres zobaczysz w zakładce **Sieć** serwera, w wierszu **NAT (wychodzący)**. Przyda się, jeśli zewnętrzna usługa wymaga dopisania Twojego adresu do listy dozwolonych.

> **Uwaga:** Port `25` jest zablokowany dla ruchu przez NAT. Jeśli serwer ma wysyłać e-maile, użyj zewnętrznego serwera pocztowego z uwierzytelnianiem na porcie `587` lub `465`.

#### Gdy NAT nie jest dostępny

Jeśli lokalizacja nie obsługuje NAT, panel przy tworzeniu serwera wyświetli ostrzeżenie:

- z włączonym **IPv6** serwer będzie miał Internet tylko przez IPv6 — usługi dostępne wyłącznie po IPv4 (np. część repozytoriów i API) nie będą osiągalne,
- bez IPv4 i IPv6 serwer **nie ma dostępu do Internetu** — także do aktualizacji i instalacji pakietów. Łączność ma tylko w sieci prywatnej projektu.

#### Jak połączyć się z takim serwerem

Ponieważ połączenia z Internetu do serwera nie docierają, masz trzy możliwości:

1. **Przez inny serwer w projekcie (bastion)** — zaloguj się przez SSH na serwer z publicznym adresem, a z niego na adres prywatny serwera, np.:
   ```
   ssh -J <użytkownik>@<adres-publiczny-bastionu> <użytkownik>@<adres-prywatny-serwera>
   ```
2. **Przez VPN** — Twój komputer dołącza do sieci prywatnej projektu. Zobacz [VPN dla firm](../chmura/vpn-dla-firm).
3. **Przez konsolę w przeglądarce** — zakładka **Konsola** w panelu serwera, bez potrzeby żadnego adresu.

Jeśli serwer ma włączone **IPv6**, możesz też połączyć się z nim bezpośrednio po IPv6.

Na stronie serwera, w karcie **Logowanie**, panel podpowiada gotowe polecenie SSH — dla serwera bez publicznego adresu używa adresu prywatnego.

#### Udostępnienie usługi z takiego serwera

Aby strona lub API z serwera bez publicznego IPv4 były dostępne z Internetu, postaw przed nim [load balancer](../chmura/load-balancer) w tym samym projekcie. Load balancer ma publiczny adres i przekazuje ruch do serwera przez sieć prywatną.

Powiązane artykuły:

- [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu)
- [Jak utworzyć serwer VPS](../serwery/tworzenie-serwera)
- [Logowanie SSH i klucze](../serwery/logowanie-ssh-i-klucze)

# Bazy danych

## Zarządzane bazy danych

Adres: https://pomoc.hostava.pl/bazy-danych/zarzadzane-bazy-danych

Jak utworzyć zarządzaną bazę PostgreSQL, MySQL, MariaDB lub Redis, włączyć wysoką dostępność, dostęp publiczny i TLS oraz jak się z nią połączyć.

Zarządzana baza danych to dedykowany serwer bazy, który instalujemy, konfigurujemy i kopiujemy za Ciebie. Ty dostajesz adres, port i hasło — resztą (aktualizacje konfiguracji, kopie zapasowe, przełączanie awaryjne w HA) zajmuje się panel.

Dostępne silniki:

| Silnik | Wersja | Port |
|---|---|---|
| PostgreSQL | 16 | 5432 |
| MySQL | 8.0 | 3306 |
| MariaDB | 10.11 | 3306 |
| Redis | 7 | 6379 |

#### Tworzenie bazy

1. W panelu przejdź do **Bazy danych** i kliknij **Utwórz bazę danych**.
2. **Silnik** — wybierz PostgreSQL, MySQL, MariaDB lub Redis.
3. **Lokalizacja** — wybierz centrum danych.
4. **Zasoby** — wybierz plan (vCPU, RAM i dysk „na dane i kopie”). Codzienne kopie zapasowe są w cenie. Rozliczenie jest godzinowe, ale w miesiącu nigdy nie zapłacisz więcej niż cena miesięczna.
5. **Sieć i dostęp**:
   - **Nazwa** — litery, cyfry, myślniki i kropki.
   - **Projekt** — baza jest zawsze dostępna w sieci prywatnej wybranego projektu (zobacz [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu)).
   - **Dostęp publiczny (adres IPv4)** — opcjonalnie, opis niżej.
   - **Wysoka dostępność (HA)** — opcjonalnie, koszt ×2.
   - **Szyfrowany dysk (at-rest)** — pojawia się tylko w lokalizacjach, które to obsługują.
   - **Weryfikowalny TLS** — opcjonalnie, opis niżej.
6. Kliknij **Utwórz bazę danych**. Tworzenie trwa zwykle 3–6 minut, strona odświeża się sama.

> **Uwaga:** W niektórych lokalizacjach baza bez adresu publicznego nie może zostać zainstalowana. Panel pokaże wtedy komunikat — włącz dostęp publiczny albo wybierz inną lokalizację.

#### Wysoka dostępność (HA) i automatyczny failover

Po włączeniu HA baza działa jako **primary + replika** na dwóch różnych serwerach fizycznych, z ciągłą replikacją danych. Gdy primary przestanie odpowiadać, panel automatycznie go odcina, promuje replikę na nowy primary i odbudowuje nową replikę. Nie musisz nic robić.

- Łącz się zawsze przez **adres zapisu** pokazany w karcie **Wysoka dostępność** na zakładce **Przegląd**. Po przełączeniu wskazuje on nowy primary.
- Karta pokazuje stan repliki i datę ostatniego failoveru. Jeśli replika jest w trakcie odbudowy, możesz ją przyspieszyć przyciskiem **Odbuduj replikę teraz**.
- Podczas failoveru aktywne połączenia zostaną zerwane — aplikacja powinna umieć ponowić połączenie.

#### Dostęp publiczny i zaufane źródła

Domyślnie baza jest dostępna **tylko w sieci prywatnej projektu** — to najbezpieczniejsza opcja. Serwery i aplikacje w tym samym projekcie łączą się z nią po adresie prywatnym.

Jeśli musisz łączyć się z zewnątrz (np. z biura lub innej chmury), włącz **Dostęp publiczny** przy tworzeniu bazy i dodaj **zaufane źródła** — adresy IP lub zakresy CIDR (IPv4 lub IPv6), maksymalnie 20. Listę możesz później zmienić w zakładce **Sieć** i zapisać przyciskiem **Zapisz**.

> **Uwaga:** Pusta lista zaufanych źródeł oznacza dostęp z dowolnego adresu (chroniony tylko hasłem). Zalecamy ograniczyć ją do konkretnych adresów.

> **Wskazówka:** Dostępu publicznego nie można obecnie włączyć ani wyłączyć w działającej bazie — zdecyduj przy tworzeniu.

#### TLS

- PostgreSQL z dostępem publicznym zawsze wymaga szyfrowanego połączenia (`sslmode=require`).
- Opcja **Weryfikowalny TLS** dodaje certyfikat serwera podpisany przez Hostava CA. W zakładce **Przegląd** kliknij **Pobierz CA** — to jeden certyfikat dla wszystkich Twoich baz. Ustaw go jako CA w kliencie i łącz się z pełną weryfikacją (`verify-full`). Redis dostaje wtedy szyfrowany port.

#### Połączenie z bazą

W zakładce **Przegląd**, w karcie **Połączenie**, znajdziesz host (prywatny i ewentualnie publiczny), port, użytkownika (`hostava` dla SQL, `default` dla Redis) i bazę domyślną `defaultdb`. Kliknij **Pokaż**, aby zobaczyć hasło oraz gotowe adresy połączenia (URI) do skopiowania.

Przykłady:

```bash
### PostgreSQL z weryfikacją certyfikatu
psql "postgresql://hostava:HASLO@HOST:5432/defaultdb?sslmode=verify-full&sslrootcert=hostava-ca.crt"

### MySQL / MariaDB
mysql -h HOST -P 3306 -u hostava -p defaultdb

### Redis (z TLS: rediss://)
redis-cli -u "redis://default:HASLO@HOST:6379"
```

#### Bazy, użytkownicy i ustawienia

- **Bazy** (SQL) — tworzysz i usuwasz bazy (nazwa: małe litery, cyfry i `_`, zaczyna się od litery). W PostgreSQL przycisk **Rozszerzenia** pozwala włączyć rozszerzenia bez restartu.
- **Użytkownicy** — tworzysz użytkowników; hasło generuje panel. Przyciski **Hasło** i **Nowe hasło** pokazują lub zmieniają hasło. Każdy użytkownik ma pełny dostęp do wszystkich baz w klastrze.
- **Metryki** — wykresy obciążenia primary i repliki.
- **Ustawienia** — **Restart**, **Zmień plan (skalowanie)** (CPU/RAM/dysk bez utraty danych, krótki restart; dysk może tylko rosnąć), **Parametry silnika** (np. maks. liczba połączeń; puste pole = wartość automatyczna, zapis wymaga krótkiego restartu) oraz **Usuń bazę danych**.

Kopie zapasowe opisujemy w artykule [Kopie zapasowe baz danych](../bazy-danych/kopie-baz-danych).

## Kopie zapasowe baz danych

Adres: https://pomoc.hostava.pl/bazy-danych/kopie-baz-danych

Jak działają automatyczne kopie zarządzanych baz danych, jak zrobić kopię na żądanie, przywrócić bazę lub utworzyć z kopii nową instancję.

Każda zarządzana baza danych ma kopie zapasowe w cenie. Nie musisz niczego włączać — kopie powstają automatycznie od chwili, gdy baza jest gotowa.

#### Jak tworzone są kopie

Panel łączy dwa rodzaje kopii w jednej liście:

- **Kopie codzienne** — wykonywane raz na dobę i przechowywane na dysku serwera bazy (dlatego plan opisuje dysk jako „na dane i kopie”). Zostaje 7 najnowszych.
- **Kopie cogodzinne** — szyfrowany zrzut bazy wysyłany co godzinę do osobnego magazynu S3, poza serwerem bazy. Starsze kopie są usuwane automatycznie.

Możesz też w każdej chwili zrobić kopię na żądanie.

> **Wskazówka:** W bazie z wysoką dostępnością (HA) kopie wykonuje zawsze aktualny primary — także po automatycznym przełączeniu na replikę.

#### Kopia na żądanie

1. Otwórz bazę w sekcji **Bazy danych** i przejdź do zakładki **Kopie zapasowe**.
2. Kliknij **Utwórz kopię teraz**.
3. Kopia pojawi się na liście. Pozycja w trakcie tworzenia ma oznaczenie **w toku…**, a nieudana — **błąd** (z opisem przyczyny).

Zrób kopię ręcznie zawsze przed ryzykowną operacją, np. migracją schematu lub masowym usuwaniem danych.

#### Przywracanie bazy z kopii

Przywrócenie **zastępuje bieżące dane** stanem z kopii. Wszystko, co zapisano po jej utworzeniu, przepada.

1. W zakładce **Kopie zapasowe** znajdź kopię z właściwą datą (najnowsze są na górze).
2. Kliknij **Przywróć**.
3. Dla bezpieczeństwa wpisz nazwę bazy i potwierdź przyciskiem **Przywróć**.
4. Przywracanie działa w tle. W tym czasie inne operacje na bazie (np. restart, nowa kopia) są zablokowane.

> **Uwaga:** Przed przywróceniem utwórz świeżą kopię bieżącego stanu. Jeśli się pomylisz, będziesz mieć do czego wrócić.

#### Nowa instancja z kopii

Gdy potrzebujesz danych z przeszłości, ale nie chcesz nadpisywać działającej bazy, utwórz z kopii osobną bazę. Przydaje się to do odzyskania pojedynczych rekordów, testów albo sprawdzenia, jak wyglądały dane wczoraj.

1. Przy kopii cogodzinnej (z magazynu S3) kliknij **Nowa instancja**.
2. Podaj **Nazwę nowej instancji** (domyślnie `nazwa-restore`).
3. Wybierz opcje: **Wysoka dostępność (HA)**, **Szyfrowanie dysku** (jeśli lokalizacja je obsługuje) i **Szyfrowane połączenia (TLS)**.
4. Kliknij **Utwórz instancję**.

Nowa baza ma ten sam silnik, plan i lokalizację co źródłowa i jest dostępna **tylko w sieci prywatnej projektu** (bez adresu publicznego). Źródłowa baza pozostaje nietknięta. Nowa instancja jest rozliczana jak zwykła baza danych — usuń ją, gdy nie będzie już potrzebna.

Jeśli włączysz HA, replika zostanie uruchomiona automatycznie po odtworzeniu danych — od tego momentu koszt rośnie dwukrotnie.

#### Usuwanie kopii

Ikona kosza przy kopii usuwa ją trwale. Zwykle nie musisz tego robić — starsze kopie znikają same. Ręczne usuwanie przydaje się głównie do posprzątania nieudanych pozycji oznaczonych jako **błąd**.

#### Co warto wiedzieć

- Usunięcie pojedynczej bazy w zakładce **Bazy** nie usuwa kopii zapasowych — możesz ją odtworzyć z kopii.
- Usunięcie całej bazy danych (zakładka **Ustawienia** → **Usuń bazę danych**) usuwa serwer **razem z kopiami zapasowymi**. Tej operacji nie można cofnąć. Jeśli potrzebujesz archiwum, wcześniej zrób własny zrzut, np.:

```bash
### PostgreSQL
pg_dump "postgresql://hostava:HASLO@HOST:5432/defaultdb?sslmode=require" -Fc -f defaultdb.dump

### MySQL / MariaDB
mysqldump -h HOST -P 3306 -u hostava -p --single-transaction defaultdb > defaultdb.sql
```

- Kopie nie są dostępne, dopóki baza się tworzy ani gdy jest zatrzymana.

Dane połączenia (host, hasło) znajdziesz w zakładce **Przegląd** — zobacz [Zarządzane bazy danych](../bazy-danych/zarzadzane-bazy-danych).

# Aplikacje

## Aplikacja z pliku Docker Compose

Adres: https://pomoc.hostava.pl/aplikacje/aplikacje-docker-compose

Jak utworzyć aplikację w kontenerach z pliku Docker Compose — plan, repliki, port publiczny, health-check, load balancer i własna domena.

Aplikacja to usługa zarządzana: wklejasz definicję Docker Compose, a panel uruchamia ją na jednej lub kilku replikach. Przy dwóch i więcej replikach ruch rozkłada load balancer z health-checkiem i HTTPS. Nie konfigurujesz Dockera ani serwerów — nie masz też do nich dostępu SSH.

> **Uwaga:** Aplikacja powinna być bezstanowa. Bazę danych trzymaj w [zarządzanej bazie danych](../bazy-danych/zarzadzane-bazy-danych), a pliki użytkowników w [magazynie S3](../chmura/magazyn-s3). Dane w wolumenach Dockera są tylko na jednej replice.

#### Tworzenie aplikacji

1. Zaloguj się do https://cloud.hostava.pl, otwórz **Aplikacje** i kliknij **Utwórz aplikację**.
2. W sekcji **Lokalizacja** wybierz centrum danych. Repliki nie mają publicznego IP i wychodzą do internetu przez NAT.
3. W sekcji **Plan repliki** wybierz zasoby (vCPU, RAM, dysk) jednej repliki. Każda replika dostaje ten sam plan.
4. W sekcji **Typ aplikacji** wybierz:
   - **Aplikacja webowa** — odpowiada na ruch HTTP, ma port, domenę z SSL i (przy 2+ replikach) load balancer,
   - **Worker** — procesy w tle (kolejki, zadania cykliczne) bez ruchu z internetu, bez portu, domeny i load balancera.
5. W sekcji **Repliki** ustaw liczbę replik (domyślnie 2, maksymalnie 10). Repliki trafiają na różne hosty.
   - **1 replika** — aplikacja dostaje publiczny adres IP, bez load balancera. Tej liczby nie zmienisz później.
   - **2 i więcej** — repliki działają za wspólnym load balancerem. Możesz włączyć **Load balancer w HA** (druga instancja LB na innym hoście, płatna osobno).
6. Opcjonalnie wpisz **Własną domenę** (np. `app.twojafirma.pl`). Domenę dodasz też później.
7. W sekcji **Aplikacja** wklej **Docker Compose** i uzupełnij:
   - **Usługa publiczna** — nazwa usługi z compose, która przyjmuje ruch (np. `web`),
   - **Port publiczny** — port, na którym nasłuchuje ta usługa (np. `8080`),
   - **Ścieżka health-check** — adres sprawdzany przed przełączeniem ruchu (np. `/health`; zwykle wystarczy `/`),
   - **Zmienne środowiskowe (.env)** — w formacie `KLUCZ=wartosc`, przechowywane zaszyfrowane,
   - **Dodatkowe porty** (opcjonalnie) — po przecinku; źródło ograniczysz zapisem `port@IP` lub `port@CIDR`, np. `5432@1.2.3.4`.
8. Opcjonalnie dodaj **Pliki** (np. certyfikat CA bazy). Trafią do katalogu `./files` obok compose przed pierwszym startem. Limit to 1 MB na plik i 5 MB łącznie.
9. Jeśli obraz jest w prywatnym rejestrze, wypełnij **Prywatny rejestr**: adres (puste = Docker Hub), użytkownika i token.
10. W **Szczegółach** podaj nazwę i wybierz projekt — repliki i load balancer trafią do jego [sieci prywatnej](../projekty-i-sieci/siec-prywatna-projektu).
11. Kliknij **Utwórz aplikację** (lub **Utwórz workera**). Tworzenie trwa zwykle kilka minut.

> **Uwaga:** Zaraz po utworzeniu panel pokaże **token deployu**. Zapisz go od razu — wyświetlamy go tylko raz. Przyda się do [wdrożeń z CI](../aplikacje/wdrozenia-z-ci).

#### Przykładowy compose

```yaml
services:
  web:
    image: ghcr.io/twoja-firma/app:latest
    restart: always
    ports:
      - "8080:8080"
    env_file: .env
    volumes:
      - ./files/certs/ca.pem:/certs/ca.pem:ro
```

Compose musi mieć sekcję `services:` na najwyższym poziomie. Nie wystawiaj portu usługi publicznej tylko na `127.0.0.1` (np. `"127.0.0.1:8080:8080"`) — load balancer nie połączy się wtedy z repliką. Panel odrzuci taką konfigurację.

#### Domena i HTTPS

Po utworzeniu otwórz zakładkę **Przegląd** i sekcję **Domena i HTTPS**:

- **2+ repliki** — skieruj domenę rekordem **CNAME** na adres load balancera pokazany w panelu, poczekaj na DNS i kliknij **Wydaj certyfikat SSL**. Certyfikat Let's Encrypt odnawia się automatycznie. Bez domeny aplikacja działa pod adresem load balancera, już z HTTPS.
- **1 replika** — skieruj domenę rekordem **A** na publiczny adres IP repliki, odczekaj ok. 2 minuty i kliknij **Wydaj certyfikat SSL**. Bez domeny aplikacja jest dostępna pod adresem IP, bez TLS.

#### Zmiany konfiguracji

Compose, `.env`, pliki, porty, health-check i rejestr zmienisz w zakładce **Konfiguracja**. Zapis nie wdraża zmian — kliknij potem **Wdróż ponownie** w **Przeglądzie**. Wdrożenie jest kroczące: replika po replice, każda dopiero po przejściu health-checku.

> **Wskazówka:** Gdy wdrożenie się nie uda, w panelu pojawi się komunikat z przyciskiem **Pokaż przyczynę (logi deployu)**. Logi działającej aplikacji znajdziesz w zakładce **Logi**, a stan kontenerów w **Metrykach**.

W zakładce **Kopie** panel trzyma ostatnie 30 wersji konfiguracji (zapisywane przy każdej zmianie i przed wdrożeniem). Możesz pobrać kopię jako plik i odtworzyć z niej aplikację przyciskiem **Wczytaj z kopii…** przy tworzeniu nowej. Kopia nie obejmuje danych z wolumenów.

Powiązane: [Wdrożenia z CI](../aplikacje/wdrozenia-z-ci), [Polecenia w aplikacji](../aplikacje/polecenia-w-aplikacji), [Repliki i plan](../aplikacje/repliki-i-plan).

## Wdrożenia z CI (GitHub Actions, GitLab CI)

Adres: https://pomoc.hostava.pl/aplikacje/wdrozenia-z-ci

Jak uruchamiać wdrożenie aplikacji z pipeline'u CI za pomocą tokenu deployu i webhooka.

Nową wersję aplikacji wdrażasz w dwóch krokach: budujesz obraz i wypychasz go do rejestru, a potem zlecasz wdrożenie. Drugi krok możesz zrobić ręcznie w panelu albo automatycznie z CI, wywołując webhook.

#### Jak działa wdrożenie

Po wywołaniu wdrożenia panel na każdej replice po kolei:

1. loguje się do prywatnego rejestru (jeśli go podałeś),
2. pobiera obrazy z compose (`docker compose pull`),
3. uruchamia nową wersję i czeka na poprawną odpowiedź pod **ścieżką health-check**,
4. dopiero wtedy przechodzi do następnej repliki.

Przy dwóch i więcej replikach aplikacja działa bez przerwy. Webhook nie zmienia compose — wdraża to, co jest zapisane w zakładce **Konfiguracja**. Dlatego najprościej używać w compose stałego tagu (np. `:latest` albo `:production`) i nadpisywać go w CI przy każdym wydaniu.

#### Wdrożenie z panelu

1. Wypchnij nowy obraz do rejestru.
2. Otwórz aplikację, zakładkę **Przegląd**.
3. Kliknij **Wdróż ponownie**.

#### Token deployu

Token pokazujemy tylko raz — zaraz po utworzeniu aplikacji. Jeśli go nie masz:

1. Otwórz aplikację i zakładkę **Deploy / CI**.
2. W sekcji **Deploy z CI (webhook)** kliknij **Wygeneruj nowy token**.
3. Skopiuj token z żółtej ramki u góry strony i zapisz go jako sekret w CI.

> **Uwaga:** Nowy token unieważnia poprzedni. Po wygenerowaniu zaktualizuj sekret we wszystkich pipeline'ach.

#### Adres webhooka

W zakładce **Deploy / CI** znajdziesz gotowe polecenie z adresem webhooka Twojej aplikacji. Ma ono postać:

```bash
curl -X POST -H "Authorization: Bearer <token>" https://cloud.hostava.pl/api/app-hooks/<identyfikator>/deploy
```

Identyfikator w adresie nie jest tajny — chroni go token. Skopiuj całe polecenie przyciskiem obok i podmień `<token>` na sekret.

Odpowiedzi webhooka:

- `200` z `{"ok":true,"started":true}` — wdrożenie wystartowało w tle,
- `401` — nieprawidłowy token,
- `409` — wdrożenie tej aplikacji już trwa.

Webhook nie czeka na koniec wdrożenia. Wynik zobaczysz w panelu: przy błędzie na stronie aplikacji pojawi się komunikat z przyciskiem **Pokaż przyczynę (logi deployu)**.

#### Przykład: GitHub Actions

Zapisz token w **Settings → Secrets and variables → Actions** jako `HOSTAVA_DEPLOY_TOKEN`, a adres webhooka jako `HOSTAVA_DEPLOY_URL`.

```yaml
### .github/workflows/deploy.yml
name: deploy
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write
    steps:
      - uses: actions/checkout@v4
      - uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}
      - uses: docker/build-push-action@v6
        with:
          push: true
          tags: ghcr.io/${{ github.repository }}:latest
      - name: Wdrożenie na Hostava
        run: |
          curl -fsS -X POST "${{ secrets.HOSTAVA_DEPLOY_URL }}" \
            -H "Authorization: Bearer ${{ secrets.HOSTAVA_DEPLOY_TOKEN }}"
```

Jeśli obraz w GHCR jest prywatny, podaj w aplikacji **Prywatny rejestr**: `ghcr.io`, nazwę użytkownika i token z uprawnieniem `read:packages`.

#### Przykład: GitLab CI

Dodaj zmienne `HOSTAVA_DEPLOY_TOKEN` (zamaskowaną) i `HOSTAVA_DEPLOY_URL` w **Settings → CI/CD → Variables**.

```yaml
deploy:
  stage: deploy
  image: curlimages/curl:latest
  script:
    - curl -fsS -X POST "$HOSTAVA_DEPLOY_URL" -H "Authorization: Bearer $HOSTAVA_DEPLOY_TOKEN"
  only:
    - main
```

#### Zawieszone wdrożenie

Jeśli wdrożenie trwa ponad 5 minut, przy komunikacie pojawi się przycisk **Odblokuj wdrożenie**. Odblokuj je, popraw konfigurację (compose, `.env`) i wdróż ponownie.

> **Wskazówka:** Migracje bazy po wdrożeniu uruchomisz w zakładce **Polecenia** — zobacz [Polecenia w aplikacji](../aplikacje/polecenia-w-aplikacji).

Powiązane: [Aplikacja z pliku Docker Compose](../aplikacje/aplikacje-docker-compose).

## Polecenia w aplikacji (migracje, seedy)

Adres: https://pomoc.hostava.pl/aplikacje/polecenia-w-aplikacji

Jak uruchamiać jednorazowe polecenia w kontenerach aplikacji, np. migracje bazy i dane startowe, bez dostępu SSH.

Do replik aplikacji nie logujesz się przez SSH. Jednorazowe zadania — migracje bazy, dane startowe, polecenia administracyjne — uruchamiasz w zakładce **Polecenia**. Wynik widzisz na żywo w panelu.

#### Uruchamianie polecenia

1. Otwórz aplikację w https://cloud.hostava.pl i przejdź do zakładki **Polecenia**.
2. W polu **Usługa z Compose** wybierz usługę, w której ma działać polecenie. Panel podpowiada nazwy z Twojego compose (jeśli masz usługę `migrate`, wybierze ją domyślnie).
3. W polu **Polecenie** wpisz polecenie, np. `npm run db:migrate`.
4. Wybierz tryb:
   - **Nowy kontener (zalecane)** — panel uruchamia nowy kontener z obrazu tej usługi, ze zmiennymi z `.env` aplikacji, a po zakończeniu go usuwa (odpowiednik `docker compose run --rm`),
   - **W działającym kontenerze** — polecenie wykona się w już uruchomionym kontenerze usługi (odpowiednik `docker compose exec`).
5. Przy kilku replikach możesz wybrać replikę z listy. Domyślnie to **Pierwsza replika**.
6. Kliknij **Uruchom** (albo naciśnij Enter w polu polecenia).

Wynik pojawi się poniżej i odświeża się co kilka sekund. Status pokazuje **trwa**, **zakończone (kod 0)** albo **błąd** z kodem wyjścia.

#### Przykłady

```bash
### Node.js
npm run db:migrate
npm run db:seed

### Laravel
php artisan migrate --force

### Django
python manage.py migrate

### Rails
bin/rails db:migrate
```

Polecenie wykonuje się przez `sh -c`, więc możesz łączyć kroki, np. `npm run db:migrate && npm run db:seed`.

#### Kiedy który tryb

- **Nowy kontener** wybieraj do migracji i seedów. Nie obciąża działającej aplikacji i działa nawet wtedy, gdy główny kontener się restartuje. Przy pierwszym uruchomieniu pobranie obrazu może chwilę potrwać.
- **W działającym kontenerze** przydaje się, gdy potrzebujesz stanu żywego procesu, np. podejrzenia plików tymczasowych albo wyczyszczenia cache w pamięci kontenera. Usługa musi wtedy działać na wybranej replice.

#### Limity

- Naraz działa **jedno polecenie** na aplikację. Kolejne uruchomisz po zakończeniu poprzedniego.
- Polecenie może trwać najwyżej **1 godzinę**. Po tym czasie zostanie przerwane z komunikatem „Przekroczono limit 1 godziny”.
- Polecenie może mieć do 4000 znaków.
- Panel pokazuje ostatnie ok. 60 KB wyniku.
- Polecenie działa tylko na replice, która jest uruchomiona.

Zadanie biegnie w tle na replice, więc zamknięcie karty przeglądarki go nie przerywa. Wrócisz do wyniku przez listę **Historia**.

> **Uwaga:** Polecenia zmieniające bazę uruchamiaj **raz**, na jednej replice. Wszystkie repliki korzystają z tej samej bazy, więc migracja wykonana na każdej z nich osobno nic nie da, a może zaszkodzić.

> **Uwaga:** Zmiany plików wykonane w trybie **W działającym kontenerze** nie są trwałe — znikną przy następnym wdrożeniu. Dotyczą też tylko jednej repliki.

#### Historia

Sekcja **Historia** pokazuje ostatnie 20 poleceń: status, usługę, treść, datę i osobę, która je uruchomiła. Kliknij wpis, aby zobaczyć jego wynik. Uruchomienie polecenia trafia też do dziennika aktywności konta.

> **Wskazówka:** Typowy przepływ po wydaniu nowej wersji: [wdrożenie z CI](../aplikacje/wdrozenia-z-ci) lub **Wdróż ponownie**, a potem migracja w zakładce **Polecenia**. Tryb **Nowy kontener** używa obrazu pobranego na replikę przy ostatnim wdrożeniu — dlatego najpierw wdróż nową wersję, a dopiero potem uruchom jej migracje.

Powiązane: [Aplikacja z pliku Docker Compose](../aplikacje/aplikacje-docker-compose), [Zarządzane bazy danych](../bazy-danych/zarzadzane-bazy-danych).

## Repliki, skalowanie i zmiana planu aplikacji

Adres: https://pomoc.hostava.pl/aplikacje/repliki-i-plan

Jak dodawać i usuwać repliki aplikacji, zmieniać plan replik bez utraty danych i kiedy używać wymiany repliki.

Aplikacja działa na jednej lub kilku replikach — osobnych maszynach, na których uruchamiamy cały Twój stack z compose. Repliki rozkładamy na różne hosty. Możesz zmieniać ich liczbę (skalowanie poziome) i plan (skalowanie pionowe).

#### Jedna replika czy kilka

- **1 replika** — aplikacja ma publiczny adres IP, bez load balancera. To najprostszy wariant, ale bez redundancji. Liczby replik nie zmienisz później — aby mieć kilka replik, utwórz nową aplikację z co najmniej dwiema (najprościej przyciskiem **Klonuj** w **Przeglądzie**).
- **2 i więcej replik** — ruch rozkłada load balancer z health-checkiem, a wdrożenia przechodzą replika po replice bez przerwy. Liczbę replik zmienisz w dowolnym momencie.
- **Worker** — nie ma load balancera, ale liczbę replik też możesz zmieniać.

#### Zmiana liczby replik

1. Otwórz aplikację w https://cloud.hostava.pl, zakładkę **Przegląd**.
2. Pod tabelą **Repliki** użyj przycisków **−** i **+** przy napisie **Repliki:**.

Nowa replika powstaje z aktualnej konfiguracji, dostaje wdrożenie i dopiero wtedy trafia do load balancera. Przy zmniejszaniu usuwamy repliki z końca listy. Maksymalnie aplikacja może mieć 10 replik. Każda replika jest rozliczana według planu, godzinowo.

#### Zmiana planu replik

Gdy aplikacji brakuje CPU lub pamięci, zmień plan — repliki dostaną więcej zasobów na tych samych maszynach.

1. Otwórz zakładkę **Ustawienia**.
2. W sekcji **Plan replik** wybierz **Nowy plan** z listy.
3. Kliknij **Zmień plan** i potwierdź.

Co się dzieje:

- Repliki są zmieniane **po kolei**: wyłączenie, nowe zasoby, start i chwila na uruchomienie kontenerów. Dopiero potem kolejna replika.
- Przy 2+ replikach aplikacja działa w tym czasie na pozostałych. Przy **jednej replice** będzie niedostępna przez ok. 1–2 minuty.
- **Dane zostają**, także w wolumenach Dockera — to te same maszyny.
- **Dysku nie da się zmniejszyć.** Lista pokazuje tylko plany z dyskiem nie mniejszym niż obecny.
- Postęp (np. „zmiana planu na …: 1/3”) zobaczysz w komunikacie na stronie aplikacji.

> **Uwaga:** Przejście na droższy plan wymaga środków na koncie na co najmniej godzinę pracy wszystkich replik w nowym planie.

#### Wymiana repliki

Przy aplikacji z load balancerem (oraz przy workerze z co najmniej dwiema replikami) każdy wiersz w tabeli **Repliki** ma przycisk **Wymień**. Wymiana:

1. tworzy nową replikę z obrazu i definicji Compose,
2. wdraża na niej aplikację i dodaje ją do load balancera,
3. dopiero po udanym wdrożeniu usuwa starą replikę.

Aplikacja działa w tym czasie na pozostałych replikach, a liczba replik się nie zmienia. Jeśli wdrożenie nowej repliki się nie uda, stara zostaje. Wymiana przydaje się, gdy jedna replika zachowuje się nieprawidłowo, a ponowne wdrożenie nie pomaga. Potwierdzasz ją, wpisując nazwę repliki.

> **Uwaga:** Dane zapisane tylko na starej replice — w wolumenach Dockera, np. baza uruchomiona jako kontener — **przepadną** przy wymianie. Zmiana planu ich nie usuwa, wymiana tak.

#### Gdzie trzymać dane

Każda replika ma własny dysk. Wolumen Dockera na jednej replice nie jest widoczny na pozostałych, a load balancer kieruje użytkowników na różne repliki. Dlatego:

- bazę danych trzymaj w [zarządzanej bazie danych](../bazy-danych/zarzadzane-bazy-danych) — ma kopie zapasowe i opcjonalną replikę z automatycznym przełączaniem,
- pliki użytkowników (zdjęcia, załączniki) zapisuj w [magazynie S3](../chmura/magazyn-s3),
- sesje i cache trzymaj w bazie lub Redisie, a nie w pamięci jednej repliki.

Baza i repliki w tym samym projekcie łączą się przez [sieć prywatną projektu](../projekty-i-sieci/siec-prywatna-projektu).

> **Wskazówka:** Kopie w zakładce **Kopie** obejmują tylko konfigurację (compose, `.env`, pliki, ustawienia), nie dane z wolumenów.

#### Samonaprawa

Repliki są usługą zarządzaną. Na każdej replice co minutę sprawdzamy health-check aplikacji (a przy workerze stan kontenerów). Po kilku kolejnych błędach kontenery są uruchamiane ponownie. Zatrzymaną replikę platforma sama uruchamia ponownie.

Powiązane: [Aplikacja z pliku Docker Compose](../aplikacje/aplikacje-docker-compose), [Wdrożenia z CI](../aplikacje/wdrozenia-z-ci).

# Usługi chmurowe

## Load balancer – rozkładanie ruchu HTTP(S) na serwery

Adres: https://pomoc.hostava.pl/chmura/load-balancer

Jak utworzyć load balancer, dodać domeny i cele, wybrać metodę równoważenia i skonfigurować certyfikat SSL.

Load balancer to stały, publiczny adres, który przyjmuje ruch HTTP i HTTPS dla Twoich domen i rozkłada go na kilka serwerów. Certyfikat SSL wystawia i odnawia automatycznie, a ruch HTTP zawsze przekierowuje na HTTPS.

#### Tworzenie load balancera

1. W menu panelu wybierz **Load balancery**, a następnie **Utwórz load balancer**.
2. W sekcji **Lokalizacja** wybierz tę samą lokalizację, w której działają serwery docelowe.
3. W sekcji **Szczegóły** podaj **Nazwę** (małe litery, cyfry, myślniki i kropki) i wybierz **Projekt**. Celami mogą być serwery z tego projektu – łączą się z load balancerem po sieci prywatnej.
4. Opcjonalnie włącz **Wysoka dostępność (HA)**. Powstanie wtedy druga instancja na osobnym hoście z tą samą konfiguracją. Gdy jedna przestanie działać, ruch obsłuży druga. Koszt jest wtedy dwukrotny.
5. Jeśli lokalizacja to oferuje, możesz włączyć **Szyfrowany dysk (at-rest)** – nie zmienia to ceny.
6. Kliknij **Utwórz load balancer**.

Instalacja trwa zwykle 2–4 minuty. Domeny możesz dodawać od razu – zostaną wgrane po zakończeniu instalacji. Usługa jest rozliczana godzinowo.

> **Wskazówka:** Serwery w projekcie łączą się z load balancerem po sieci prywatnej, więc nie muszą mieć otwartych portów do Internetu. Więcej o sieci projektu: [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu).

#### Dodawanie domeny i celów

1. Otwórz load balancer i przejdź do zakładki **Domeny**.
2. Kliknij **Dodaj domenę**.
3. W polu **Domeny** wpisz nazwę (np. `sklep.pl`) i kliknij **Dodaj**. Możesz dodać do 10 nazw w jednej pozycji, np. `sklep.pl` i `www.sklep.pl`.
4. W sekcji **Cele** wybierz serwer z projektu z listy (zostanie użyty jego adres prywatny) albo wpisz dowolny **adres IP**. Podaj **port** (domyślnie 80) i kliknij **+**. Powtórz dla kolejnych serwerów.
5. Wybierz **Metodę równoważenia**:
   - **Round robin** – zapytania trafiają po kolei do każdego celu,
   - **Najmniej połączeń** – zapytanie trafia do celu z najmniejszą liczbą aktywnych połączeń,
   - **IP hash** – ten sam klient zawsze trafia na ten sam serwer (przydatne przy sesjach zapisanych lokalnie).
6. W polu **Test zdrowia (ścieżka)** podaj adres, który aplikacja obsługuje szybko i poprawnie (domyślnie `/`). Cele, które nie odpowiadają, są pomijane.
7. Kliknij **Zapisz**. Zmiany są wgrywane od razu, bez przerwy w ruchu.

> **Uwaga:** Opcję **HTTPS do celów** włącz tylko wtedy, gdy Twoja aplikacja sama nasłuchuje po HTTPS. Aplikacje na portach 80, 8080 czy 3000 zwykle mówią zwykłym HTTP i nie zrozumieją zaszyfrowanego ruchu. Certyfikat dla odwiedzających i tak jest obsługiwany przez load balancer.

Domena bez żadnego celu odpowiada błędem 503.

#### Ustawienie DNS

Na zakładce **Przegląd** zobaczysz, jak skierować domenę:

- jeśli panel pokazuje **Endpoint**, ustaw u operatora domeny rekord **CNAME** na ten adres, np.:

  ```
  sklep.pl.   CNAME   <endpoint-z-panelu>.
  ```

  Adresy pod endpointem utrzymujemy my – także przy awarii instancji w trybie HA.
- jeśli panel pokazuje **Adres publiczny**, ustaw rekord **A** na ten adres IP.

> **Wskazówka:** Domena główna (np. `sklep.pl` bez `www`) u wielu operatorów nie może mieć rekordu CNAME. Sprawdź, czy Twój operator DNS obsługuje CNAME (lub ALIAS/ANAME) dla domeny głównej.

#### Certyfikat SSL

Domyślnie certyfikat Let's Encrypt jest wystawiany automatycznie, gdy rekord DNS zacznie wskazywać na load balancer, i odnawiany bez Twojego udziału. Jeśli chcesz użyć własnego certyfikatu, w oknie edycji domeny włącz **Własny certyfikat SSL** i wklej certyfikat (razem z łańcuchem pośrednim) oraz klucz prywatny. Przy edycji możesz zostawić pola puste, aby zachować obecny certyfikat.

#### Sprawdzanie stanu

Zakładka **Stan** pokazuje:

- **Domeny i certyfikaty** – czy domena wskazuje na load balancer („wskazuje tutaj”) i czy certyfikat jest wystawiony („czeka na DNS”, „wystawianie…”, „wystawiony”),
- **Cele** – wynik testu zdrowia każdego celu (kod HTTP i czas odpowiedzi albo „brak odpowiedzi”),
- **Ostatnie błędy (6 h)** – jeśli wystąpiły.

#### Ustawienia i usuwanie

W zakładce **Ustawienia** możesz zrestartować instancję (**Restart**) albo uruchomić zatrzymaną (**Uruchom**). Przycisk **Usuń load balancer** usuwa instancję (lub obie w trybie HA) i adres – domeny przestaną działać, ale serwery docelowe pozostaną bez zmian. Usunięcie wymaga przepisania nazwy load balancera.

Zobacz też: [Aplikacje Docker Compose](../aplikacje/aplikacje-docker-compose), [Zapora sieciowa](../serwery/zapora-sieciowa).

## Klaster Kubernetes

Adres: https://pomoc.hostava.pl/chmura/kubernetes

Jak utworzyć klaster Kubernetes, włączyć wysoką dostępność, pobrać kubeconfig, skalować workery i wdrażać z CI/CD.

W panelu uruchomisz lekki klaster Kubernetes (k3s) zgodny ze standardowym Kubernetes – działa `kubectl` i zwykłe manifesty. Węzły klastra to maszyny w sieci prywatnej Twojego projektu.

#### Tworzenie klastra

1. W menu wybierz **Kubernetes**, a następnie **Utwórz klaster**.
2. Wybierz **Lokalizację**.
3. W sekcji **Plan węzła** wybierz rozmiar maszyn. Ten sam plan dotyczy wszystkich węzłów (masterów i workerów). Mniejszym aplikacjom wystarczy 4 GB RAM.
4. W sekcji **Węzły klastra** ustaw liczbę **workerów** przyciskami **–** / **+** (minimum 1, domyślny limit to 10). Workery dodasz i usuniesz też później.
5. Opcjonalnie włącz **Wysoka dostępność (HA)** – opis poniżej.
6. Jeśli lokalizacja to oferuje, możesz włączyć **Szyfrowany dysk (at-rest)** dla dysków węzłów.
7. W sekcji **Szczegóły** podaj **Nazwę** i wybierz **Projekt** – węzły łączą się po [sieci prywatnej projektu](../projekty-i-sieci/siec-prywatna-projektu).
8. Kliknij **Utwórz klaster**.

Tworzenie trwa zwykle kilka minut. Klaster jest rozliczany godzinowo: cena to liczba węzłów razy cena planu (plus load balancery API w trybie HA).

#### Wysoka dostępność (HA)

Bez HA klaster ma jeden master. Po włączeniu HA powstają **trzy mastery z wbudowanym etcd** na różnych serwerach fizycznych, a przed nimi dwa niewielkie load balancery API (port TCP 6443). Awaria jednego mastera lub całego hosta nie zatrzymuje klastra, a `kubectl` łączy się dalej bez żadnych zmian po Twojej stronie. HA dolicza 2 dodatkowe mastery i 2 load balancery API – panel pokazuje pełną cenę przed utworzeniem.

#### Kubeconfig i połączenie z kubectl

Gdy master się uruchomi, aktywny stanie się przycisk **Kubeconfig** u góry strony klastra (jest też w zakładce **Ustawienia**). Pobrany plik nazywa się `<nazwa-klastra>-kubeconfig.yaml`.

```bash
export KUBECONFIG=./moj-klaster-kubeconfig.yaml
kubectl get nodes
```

> **Uwaga:** Kubeconfig zawiera certyfikaty administratora. Traktuj go jak hasło – kto go ma, zarządza całym klastrem. Do automatyzacji używaj tokenów wdrożeniowych (poniżej).

#### Węzły i skalowanie

Zakładka **Węzły** pokazuje każdy węzeł z rolą (master, worker, API LB), statusem oraz adresem prywatnym i publicznym.

- **Dodaj worker** – dokłada nową maszynę do klastra.
- Ikona kosza przy workerze usuwa go; pody zostaną przełożone na pozostałe węzły. Klaster musi mieć co najmniej jeden worker.
- Mastera nie można usunąć osobno – usuwa się razem z całym klastrem.

Zakładka **Metryki** pokazuje wykresy użycia zasobów poszczególnych węzłów.

#### Udostępnianie aplikacji

Ruch HTTP(S) do aplikacji obsługuje wbudowany ingress (Traefik). W klastrze HA zakładka **Load balancer** pozwala dodatkowo wystawić dowolny port TCP:

1. Utwórz Service typu NodePort, np.:

   ```bash
   kubectl expose deploy web --type=NodePort --port=80
   kubectl get svc web
   ```

2. Odczytaj przydzielony `nodePort` (zakres 30000–32767).
3. W zakładce **Load balancer** kliknij **Dodaj regułę**, wpisz **Port publiczny** (np. 443), **NodePort** i opcjonalny **Opis**.
4. Kliknij **Zapisz i wgraj**.

Port 6443 jest zarezerwowany dla API. Szyfrowanie TLS obsłuż w aplikacji lub ingressie. Domenę kieruj rekordem CNAME na adres aplikacji pokazany w tej zakładce – jest on osobny od adresu API używanego przez `kubectl`.

#### Wdrożenia z CI/CD

W zakładce **CI/CD** utworzysz tokeny wdrożeniowe – osobne konta usługi w klastrze, dzięki którym pipeline nie potrzebuje kubeconfig administratora.

1. Kliknij **Nowy token**.
2. Podaj **Nazwę** (np. `github-produkcja`) i **Namespace** – zostanie utworzony, jeśli nie istnieje.
3. W **Uprawnieniach** wybierz **Tylko ten namespace (zalecane)** albo **Cały klaster (administrator)** – ten drugi tylko, gdy pipeline instaluje np. CRD lub operatory.
4. Kliknij **Utwórz token** i od razu zapisz dane – token i kubeconfig widać **tylko raz**.

Możesz zapisać cały kubeconfig jako jeden sekret `KUBECONFIG` albo trzy sekrety: `K8S_SERVER`, `K8S_CA`, `K8S_TOKEN`. Przykład dla GitHub Actions:

```yaml
- name: kubeconfig
  run: |
    mkdir -p ~/.kube
    echo "${{ secrets.KUBECONFIG }}" > ~/.kube/config
- name: deploy
  run: |
    kubectl apply -f k8s/
    kubectl -n default rollout status deployment/my-app
```

Gotowe przykłady dla GitHub Actions i GitLab CI znajdziesz w zakładce **CI/CD**. Przycisk **Odwołaj** natychmiast odbiera tokenowi dostęp.

#### Kopie zapasowe i usuwanie

W zakładce **Ustawienia** karta **Kopie zapasowe** pokazuje czas ostatniej kopii aplikacji i danych oraz stanu klastra (etcd). Jeśli kopie są włączone w danej lokalizacji, powstają automatycznie co 6 godzin i są przechowywane poza klastrem przez 7 dni. Jeżeli dostępna jest karta **Migracja na inny host (failover)**, przycisk **Odtwórz na innym hoście** postawi klaster od nowa z ostatniej kopii – adres i kubeconfig zostają bez zmian, ale zmiany z ostatnich (do 6) godzin mogą przepaść.

**Usuń klaster** kasuje wszystkie węzły razem z danymi na ich dyskach. Operacji nie można cofnąć.

> **Wskazówka:** Dane, które muszą przetrwać wszystko, trzymaj poza klastrem – w [zarządzanej bazie danych](../bazy-danych/zarzadzane-bazy-danych) lub w [magazynie S3](../chmura/magazyn-s3).

## Magazyn plików S3 (Storage S3)

Adres: https://pomoc.hostava.pl/chmura/magazyn-s3

Jak tworzyć buckety i klucze dostępu w Storage S3 oraz łączyć się z nimi przez aws-cli, rclone lub SDK.

**Storage S3** to magazyn obiektów zgodny z S3. Przechowasz w nim kopie zapasowe, pliki przesyłane przez użytkowników aplikacji czy statyczne pliki strony. Połączysz się z nim z dowolnego narzędzia obsługującego S3 – aws-cli, rclone czy bibliotek SDK.

Na górze strony widzisz zajęte miejsce, liczbę bucketów i transfer wychodzący w bieżącym miesiącu. Płacisz za przechowywane dane (za GB miesięcznie) i za pobrane dane (za GB transferu wychodzącego), rozliczane godzinowo.

#### Tworzenie bucketu

1. W menu wybierz **Storage S3** i zakładkę **Buckety**.
2. Kliknij **Utwórz bucket**.
3. Podaj **Nazwę**: 3–63 znaki, małe litery, cyfry, myślniki i kropki. Nazwy są globalne – nie mogą się powtarzać między kontami.
4. Opcjonalnie włącz **Publiczny** – pliki będą dostępne do pobrania bez klucza (np. obrazy na stronie).
5. Kliknij **Utwórz**.

Na jednym koncie możesz mieć do 100 bucketów.

Po kliknięciu nazwy bucketu otworzysz przeglądarkę plików: **Wyślij pliki** z komputera, utwórz **Katalog**, pobierz plik albo zaznacz pozycje i je usuń. W tym miejscu możesz też zmienić dostęp prywatny/publiczny – dla publicznego bucketu panel pokazuje jego adres publiczny i pozwala skopiować link do pliku. Przeglądarka pokazuje do 500 pozycji w katalogu; pełną listę zobaczysz w kliencie S3.

> **Uwaga:** **Usuń bucket** wymaga przepisania nazwy. Jeśli bucket nie jest pusty, zaznacz **Usuń też wszystkie obiekty (opróżnij i usuń)**. Tej operacji nie można cofnąć.

#### Klucze dostępu

Do połączenia z narzędzi i aplikacji potrzebujesz klucza (Access Key + Secret Key).

1. Przejdź do zakładki **Klucze dostępu** i kliknij **Nowy klucz**.
2. Podaj **Nazwę** (np. `backup-serwera`).
3. Opcjonalnie włącz **Tylko odczyt** lub **Tylko wybrane buckety** i zaznacz buckety.
4. Kliknij **Utwórz**.
5. Skopiuj **Secret Key** od razu – nie będzie można go wyświetlić ponownie.

Klucz ograniczony do wybranych bucketów lub tylko do odczytu nie może tworzyć ani usuwać bucketów. Możesz mieć do 50 kluczy. Ikona kosza unieważnia klucz – aplikacje, które go używają, stracą dostęp w ciągu kilkunastu sekund.

> **Wskazówka:** Twórz osobny klucz dla każdej aplikacji czy serwera i ogranicz go do potrzebnych bucketów. W razie wycieku unieważnisz tylko ten jeden klucz.

#### Dane połączenia

Zakładka **Połączenie** pokazuje **Endpoint** i **Region**. Obsługiwane są adresy ścieżkowe (`<endpoint>/bucket/plik`) i wirtualne (`https://bucket.<domena-endpointu>/plik`), wysyłanie dużych plików w częściach (multipart), listowanie, kopiowanie oraz adresy presigned. Uprawnienia i dostęp publiczny ustawiasz w panelu.

W przykładach poniżej zastąp `<ENDPOINT>`, `<REGION>`, `<ACCESS_KEY>` i `<SECRET_KEY>` wartościami z panelu (w zakładce **Połączenie** gotowe przykłady mają już wpisany endpoint i region).

##### aws-cli

```bash
aws configure set aws_access_key_id <ACCESS_KEY>
aws configure set aws_secret_access_key <SECRET_KEY>
aws configure set region <REGION>
aws --endpoint-url <ENDPOINT> s3 ls
aws --endpoint-url <ENDPOINT> s3 cp plik.zip s3://moj-bucket/
```

##### rclone

Dodaj do pliku `~/.config/rclone/rclone.conf`:

```ini
[hostava]
type = s3
provider = Other
endpoint = <ENDPOINT>
access_key_id = <ACCESS_KEY>
secret_access_key = <SECRET_KEY>
region = <REGION>
```

Następnie, np. synchronizacja katalogu z bucketem:

```bash
rclone sync /var/backups hostava:moj-bucket/backups
```

##### SDK (JavaScript)

```js
import { S3Client } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  endpoint: '<ENDPOINT>',
  region: '<REGION>',
  credentials: { accessKeyId: '<ACCESS_KEY>', secretAccessKey: '<SECRET_KEY>' },
});
```

Zobacz też: [Kopie i migawki serwera](../serwery/kopie-i-migawki), [Repliki i plan aplikacji](../aplikacje/repliki-i-plan).

## VPN dla firm

Adres: https://pomoc.hostava.pl/chmura/vpn-dla-firm

Jak uruchomić firmowy VPN oparty na WireGuard, dodać użytkowników i urządzenia oraz połączyć serwery w jedną prywatną sieć.

VPN w https://cloud.hostava.pl to prywatna sieć dla Twojego zespołu i serwerów, oparta na WireGuard. Pracownicy łączą się z telefonu lub laptopa, a serwery (także spoza Hostavy) mogą rozmawiać ze sobą po adresach VPN.

#### Włączenie VPN

1. Wejdź w menu **VPN**.
2. Kliknij **Włącz VPN**. Samo włączenie nic nie kosztuje — płacisz tylko za utworzony serwer VPN w Hostavie (rozliczenie godzinowe z limitem miesięcznym). Użytkownicy, urządzenia i VPN na własnym serwerze są bez opłat.

Panel VPN ma zakładki: **Przegląd**, **Serwery**, **Użytkownicy**, **Maszyny**, **Połączenia** i **Ustawienia**.

#### Serwer VPN: w Hostavie czy własny

W zakładce **Serwery** masz dwie możliwości:

- **Nowy serwer VPN** (serwer w Hostavie) — podajesz nazwę, **Lokalizację** i **Sieć prywatną projektu**. Serwer jest gotowy w kilka minut, bez żadnej konfiguracji.
- **Dodaj własny serwer** — Twój serwer z Linuksem (Ubuntu, Debian, AlmaLinux, Rocky, z systemd). Po kliknięciu **Dodaj i pokaż polecenie** dostajesz jedno polecenie do uruchomienia jako root. Jest jednorazowe i ważne 24 godziny. Serwer musi mieć otwarty port UDP (domyślnie 51820) i wychodzący dostęp HTTPS. Status zmieni się sam po instalacji.

> **Wskazówka:** Jeśli instalacja serwera w Hostavie się nie powiedzie, na stronie serwera kliknij **Ponów instalację** — zwykle jedno ponowienie wystarcza.

Na stronie serwera widzisz m.in. **Adres dla klientów**, **Sieć tunelu** i liczbę połączonych urządzeń. Możesz tam też wyłączyć serwer (wyłączony nie przyjmuje połączeń) i przypisać go do grupy.

#### Użytkownicy i urządzenia

1. W zakładce **Użytkownicy** kliknij **Dodaj użytkownika**, podaj imię i nazwisko oraz opcjonalnie e-mail i grupy.
2. Na stronie użytkownika, w sekcji **Urządzenia**, kliknij **Dodaj urządzenie** (np. „Telefon”, „Laptop”). Każde urządzenie ma własne klucze, więc mogą działać jednocześnie.
3. Przy urządzeniu kliknij przycisk z nazwą serwera VPN. Otworzy się okno z konfiguracją:
   - **telefon** — w aplikacji WireGuard wybierz „+” → „Skanuj kod QR”,
   - **komputer** — kliknij **Pobierz** plik `.conf` i zaimportuj go w aplikacji WireGuard.

> **Uwaga:** Plik konfiguracji zawiera klucz prywatny. Przekaż go wyłącznie właścicielowi urządzenia.

W sekcji **Dostęp** ustawisz też:

- **Aktywny** — wyłączenie od razu przerywa połączenia na wszystkich serwerach,
- **Dostęp ważny do** — data wygaśnięcia (przyciski **+30 dni**, **+1 rok**, **Bez terminu**),
- **Limit urządzeń** — puste oznacza brak limitu.

#### Grupy dostępu

Grupy decydują, kto łączy się z którym serwerem VPN. Dodasz je w zakładce **Użytkownicy**, w karcie **Grupy dostępu**, a serwer przypiszesz do grupy na jego stronie.

- Użytkownik **bez grup** ma dostęp do wszystkich serwerów VPN.
- Użytkownik **z grupami** ma dostęp tylko do serwerów z tych grup.

#### Dostęp do serwerów w sieci prywatnej projektu

Serwer VPN w Hostavie może dać pracownikom dostęp do Twoich serwerów po ich adresach prywatnych — bez instalowania czegokolwiek na tych serwerach.

1. Przy tworzeniu serwera VPN wybierz **Sieć prywatną projektu** (albo zmień ją później na stronie serwera VPN). Zmiana projektu uruchamia serwer VPN ponownie — urządzenia stracą połączenie na około minutę i połączą się same.
2. W zakładce **Ustawienia** włącz **Dostęp do sieci prywatnych przez serwer VPN**. Bez tego klienci widzą przez VPN tylko internet.

Więcej o sieciach projektów: [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu).

#### Maszyny — serwery w jednej sieci (site-to-site)

Zakładka **Maszyny** łączy Twoje serwery w jedną prywatną sieć, np. aplikację z bazą w innym projekcie albo u innego dostawcy. Przez VPN idzie tylko ruch do sieci tunelu — reszta ruchu serwera się nie zmienia.

1. Wybierz **Serwer VPN** i opcjonalnie **Grupę**.
2. **Twoje serwery w Hostavie** — zaznacz uruchomione serwery i kliknij **Dołącz zaznaczone**. WireGuard zainstaluje się automatycznie, bez restartu.
3. **Serwery spoza Hostavy** — kliknij **Dołącz serwer**, a potem **Pokaż polecenie** i uruchom je jako root (jednorazowe, ważne 24 godziny). Klucz prywatny powstaje na serwerze i go nie opuszcza; wystarczy wychodzący ruch UDP do serwera VPN.

> **Uwaga:** Domyślnie urządzenia w VPN nie widzą się nawzajem. Aby maszyny mogły się łączyć, kliknij **Pozwól maszynom się łączyć** albo w **Ustawieniach** włącz **Użytkownicy i maszyny widzą się nawzajem**.

#### Połączenia, logi i webhooki

- **Połączenia** — historia sesji z filtrem po użytkowniku, serwerze, stanie i dacie oraz eksport do **CSV**.
- **Ustawienia → Logi połączeń** — tryb **Pełne**, **Bez adresów IP** albo **Wyłączone**, okres przechowywania i automatyczne zwalnianie nieużywanych urządzeń. Zawężenie logów usuwa już zapisane dane.
- **Webhooki** — powiadomienia HTTP POST o zdarzeniach (np. nowy użytkownik, wygaśnięcie dostępu, połączenie) podpisane nagłówkiem `X-Hostava-Signature` (HMAC-SHA256). Nieudane doręczenia ponawiamy przez 6 godzin.

#### Usunięcie serwera VPN

Usunięcie serwera w Hostavie kasuje jego maszynę. Własny serwer zostaje tylko odłączony od panelu — VPN wyłączysz na nim poleceniem:

```bash
systemctl disable --now hostava-vpn-agent wg-quick@wg0
```

Zobacz też: [Zapora sieciowa](../serwery/zapora-sieciowa).

## Serwer logów

Adres: https://pomoc.hostava.pl/chmura/serwer-logow

Jak utworzyć serwer logów, podłączyć do niego serwery i aplikacje, przeszukiwać wpisy i ustawić alerty.

Serwer logów zbiera logi z Twoich serwerów i aplikacji w jednym miejscu, a Ty przeszukujesz je w https://cloud.hostava.pl. To osobna maszyna w Twoim projekcie — nie dzielisz jej z nikim, a domyślnie przyjmuje logi tylko z sieci prywatnej projektu. Obsługuje syslog, Graylog (GELF), HTTP, Elasticsearch, Loki i OpenTelemetry.

#### Tworzenie serwera logów

1. Wejdź w **Logi** i kliknij **Utwórz serwer logów**.
2. Wybierz **Lokalizację** i **Projekt** — serwery tego projektu wyślą logi siecią prywatną.
3. Wybierz **Poziom**:
   - **Dev** — jedna instancja, do testów,
   - **Produkcja (HA)** — dwie instancje na różnych serwerach fizycznych; awaria jednej nie przerywa zbierania ani wyszukiwania.
4. Wybierz **Pojemność na logi** (GB dysku; w HA w każdej z 2 instancji).
5. Ustaw, **jak długo przechowywać logi**: 7, 14, 30, 90, 180 lub 365 dni. Starsze wpisy usuwamy automatycznie, a gdy dysk się zapełni, najstarsze dane znikną wcześniej.
6. Opcjonalnie włącz **Dostęp z Internetu** (dla serwerów i aplikacji spoza projektu lub spoza Hostavy) i podaj **Zaufane adresy (IP/CIDR)**.
7. Nadaj nazwę i kliknij **Utwórz serwer logów**. Instalacja trwa kilka minut.

Usługa jest rozliczana godzinowo z salda.

#### Podłączanie serwerów (agent)

Najprostsza droga to agent Hostava, który wysyła dziennik systemowy (w tym logowania SSH i `sudo`) oraz logi nginx i Apache.

- Na stronie serwera logów, w zakładce **Podłączanie**, karta **Serwery wysyłające logi** pokazuje Twoje serwery ze wszystkich projektów. Kliknij **Podłącz** przy wybranym (musi być uruchomiony). Instalacja agenta trwa zwykle 1–2 minuty.
- Możesz też włączyć to od strony serwera: zakładka **Bezpieczeństwo** → karta **Wysyłanie logów** → **Włącz wysyłanie logów**.

Serwery z tego samego projektu wysyłają logi siecią prywatną, pozostałe przez Internet (HTTPS) — wymaga to włączonego dostępu z Internetu. Agenta usuniesz przyciskiem **Wyłącz**.

#### Wysyłanie logów z aplikacji i własnych narzędzi

W zakładce **Podłączanie** znajdziesz adresy, porty, login i **token zapisu** (przycisk **Pokaż token**) oraz gotowe konfiguracje. Domyślne porty:

- HTTP (sieć prywatna): 9428, HTTPS (Internet): 9443,
- syslog: 514 TCP/UDP, GELF: 12201 TCP/UDP.

Przykład dla rsyslog (`/etc/rsyslog.d/90-hostava.conf`, potem `systemctl restart rsyslog`):

```
*.* @@10.0.0.5:514
```

Przykład wysłania wpisu przez HTTP (JSON, po jednym w linii):

```bash
curl -u LOGIN:TOKEN -H 'Content-Type: application/x-ndjson' \
  -X POST 'http://10.0.0.5:9428/insert/jsonline?_stream_fields=host,app&_msg_field=message&_time_field=timestamp' \
  -d '{"host":"web-01","app":"sklep","message":"zamówienie 123 opłacone"}'
```

Zamiast `10.0.0.5`, `LOGIN` i `TOKEN` wstaw wartości z panelu. Dla Fluent Bit, Filebeat i Logstash użyj wyjścia Elasticsearch, a dla Promtail i OpenTelemetry — adresów podanych w panelu.

> **Wskazówka:** Token zapisu pozwala tylko dopisywać wpisy. Nawet przejęty serwer, który go używa, nie odczyta logów innych systemów.

> **Uwaga:** W poziomie **Produkcja (HA)** wysyłaj każdy log do **obu** adresów instancji, żeby awaria jednej niczego nie gubiła. Agent Hostava robi to sam.

Z Internetu logi przyjmujemy przez HTTPS z tokenem — certyfikat serwera pobierzesz w zakładce **Podłączanie**. Syslog i GELF nie mają uwierzytelnienia ani szyfrowania, więc z Internetu działają wyłącznie dla adresów z listy zaufanych.

#### Wyszukiwanie

W zakładce **Wyszukiwanie**:

1. Wpisz zapytanie, np. `error`, `SYSLOG_IDENTIFIER:sshd` albo `app:nginx "500"`. Działa pełna składnia LogsQL, np. `error AND NOT timeout` lub `error | stats by (host) count()`.
2. Wybierz zakres (od 15 min do 30 dni albo **Własny**) i opcjonalnie **Systemy**, z których chcesz widzieć wpisy.
3. Kliknij **Szukaj**. Kliknięcie wpisu pokazuje wszystkie jego pola.

Przyciskiem **CSV** pobierzesz wyniki według bieżących filtrów (do 10 000 najnowszych wpisów).

#### Alerty

W zakładce **Alerty**:

1. W karcie **Powiadomienia** włącz **E-mail na adres konta** i/lub podaj **Webhook** (https://, np. Slack). Webhook dostaje POST z JSON: reguła, liczba wystąpień, hosty, czas.
2. W **Regułach wykrywania** włącz gotowe reguły, np. **Próby włamania przez SSH**, **Logowanie na root przez SSH**, **Brak pamięci (OOM)**, **Pełny dysk**, **Awaria usługi**, **Błędy serwera WWW (5xx)**, **Atak na logowanie WordPress** czy **System przestał wysyłać logi**. Możesz zmienić próg i okno czasowe.
3. Przyciskiem **Własna reguła** dodasz regułę z własnym zapytaniem: „Alert, gdy co najmniej N wystąpień w ciągu X min”.

Reguły sprawdzamy co 5 minut. Po alercie ta sama reguła milczy przez godzinę. Gotowe reguły korzystają z logów wysyłanych przez agenta Hostava.

#### Ustawienia

W zakładce **Ustawienia** zmienisz okres przechowywania (w dniach), sprawdzisz zajętość dysku, zmienisz **Dostęp z Internetu** i listę zaufanych adresów.

> **Uwaga:** Jeśli serwer logów został utworzony bez dostępu z Internetu, nie ma adresu publicznego i przyjmuje logi tylko z sieci prywatnej swojego projektu. Aby zbierać logi z innych projektów lub spoza Hostavy, utwórz serwer logów z włączonym dostępem z Internetu.

W tej samej zakładce usuniesz serwer logów — razem ze wszystkimi zebranymi logami, bez możliwości cofnięcia.

Zobacz też: [Sieć prywatna projektu](../projekty-i-sieci/siec-prywatna-projektu), [Zapora sieciowa](../serwery/zapora-sieciowa).

# Konto i rozliczenia

## Doładowanie konta

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/doladowanie-konta

Jak doładować saldo prepaid, czym różni się kwota netto od brutto i jak podać dane do faktury.

Hostava działa w modelu **prepaid**: najpierw doładowujesz saldo, a opłaty za usługi pobieramy z niego automatycznie. Saldo widzisz cały czas na górnym pasku panelu.

#### Netto, brutto i VAT

Saldo i wszystkie ceny w panelu są **netto**. Przy płatności doliczamy VAT (obecnie `23%`).

| Wybierasz kwotę | Płacisz | Na saldo trafia |
|---|---|---|
| `100 zł` netto | `123 zł` brutto | `100 zł` |
| `50 zł` netto | `61,50 zł` brutto | `50 zł` |

Faktura jest wystawiana na kwotę brutto płatności.

#### Jak doładować konto

1. W menu wybierz **Konto → Rozliczenia**.
2. W karcie **Doładuj konto** kliknij jedną z kwot (`20`, `50`, `100`, `200`, `500 zł`) albo wpisz własną w polu **Inna kwota (zł netto)**.
3. Sprawdź dane w sekcji **Dane do faktury** (patrz niżej).
4. Kliknij **Zapłać … brutto** — przycisk pokazuje dokładną kwotę z VAT.
5. Dokończ płatność u operatora płatności i wróć do panelu.

Po zaksięgowaniu wpłaty saldo zwiększa się automatycznie, a Ty dostajesz e-mail z potwierdzeniem. Stan płatności widzisz w karcie **Płatności**: *Oczekuje*, *Opłacona*, *Odrzucona* albo *Anulowana*.

Limity jednego doładowania:

- minimum: `10 zł` netto,
- maksimum: `10 000 zł` netto.

> **Wskazówka:** Serwery zawieszone z powodu braku środków wznawiamy automatycznie po zaksięgowaniu wpłaty — nie musisz nic klikać.

#### Dane do faktury

W karcie **Doładuj konto** jest sekcja **Dane do faktury**:

- **Nazwa / firma** — nazwa firmy albo imię i nazwisko,
- **NIP** — opcjonalnie (dla osób prywatnych zostaw puste),
- **Adres**, **Kod pocztowy**, **Miejscowość**, **Kraj**.

Kliknij **Zapisz dane do faktury**. Zapisanie nie wymaga płatności — dane zostaną użyte przy tym i każdym kolejnym doładowaniu, także automatycznym.

> **Uwaga:** Zawsze kliknij **Zapisz dane do faktury** przed płatnością. Do płatności dołączamy dane zapisane w profilu w chwili jej utworzenia — późniejsza zmiana nie poprawi już faktury za tę wpłatę. Bez danych do faktury nie wystawimy faktury za doładowanie.

#### Ile wystarczy środków

W karcie salda w **Rozliczeniach** widzisz:

- **Saldo (netto)** i informację, na ile czasu wystarczy przy obecnym zużyciu,
- **Koszt / godz. netto** — ile kosztują teraz wszystkie Twoje usługi godzinowe,
- **Prognoza / mies.** i **Ten miesiąc** — przewidywany i dotychczasowy koszt.

Gdy środków zostanie na mniej niż około 3 dni pracy usług, wyślemy Ci e-mail z ostrzeżeniem (chyba że masz włączone automatyczne doładowanie).

#### Historia

- **Historia transakcji** — każde doładowanie, opłata, zwrot i korekta z saldem po operacji.
- **Płatności** — ostatnie płatności z kwotą netto i brutto.
- **Faktury** — pliki PDF do pobrania.

Nieopłacona płatność w stanie *Oczekuje* zostaje automatycznie anulowana po 7 dniach.

Powiązane artykuły:

- [Automatyczne doładowanie kartą](../konto-i-rozliczenia/automatyczne-doladowanie)
- [Jak liczymy koszty](../konto-i-rozliczenia/jak-liczymy-koszty)
- [Faktury](../konto-i-rozliczenia/faktury)

## Automatyczne doładowanie kartą

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/automatyczne-doladowanie

Jak włączyć automatyczne doładowanie salda kartą płatniczą, jak działa próg i kwota oraz jakie są zabezpieczenia.

Automatyczne doładowanie pilnuje, żeby saldo nie spadło do zera i Twoje serwery nie zostały zawieszone. Gdy saldo spadnie poniżej ustawionego progu, doładujemy konto z zapisanej karty.

Dane karty wpisujesz w bezpiecznym formularzu operatora płatności PayU — nie trafiają na nasze serwery. Panel przechowuje tylko token karty i jej zamaskowany numer.

#### Jak włączyć

1. Wejdź w **Konto → Rozliczenia** i znajdź kartę **Automatyczne doładowanie**.
2. W polu **Gdy saldo spadnie poniżej (zł netto)** wpisz próg, np. `20`.
3. W polu **Doładuj kwotą (zł netto)** wpisz kwotę doładowania, np. `100`. Pod polem widzisz, ile pobierzemy z karty brutto.
4. Wpisz numer karty, datę ważności i CVV.
5. Zaznacz zgodę na obciążanie karty.
6. Kliknij **Zapisz kartę i doładuj … brutto**.
7. Potwierdź płatność w swoim banku (3-D Secure).

Pierwsza płatność od razu doładowuje konto wybraną kwotą i jednocześnie potwierdza kartę. Po jej zaksięgowaniu automatyczne doładowanie ma status **włączone**.

> **Wskazówka:** Faktury za automatyczne doładowania wystawiamy na dane zapisane w sekcji **Dane do faktury** — uzupełnij je wcześniej. Po każdym doładowaniu wyślemy e-mail, a fakturę osobną wiadomością.

#### Limity i zabezpieczenia

| Zasada | Wartość |
|---|---|
| Minimalna kwota doładowania | `10 zł` netto |
| Maksymalna kwota doładowania | `10 000 zł` netto |
| Częstotliwość | najwyżej **raz na 6 godzin** |
| Nieudane próby | po **3 nieudanych próbach z rzędu** doładowanie wyłącza się |

Saldo sprawdzamy co kilka minut. Nawet jeśli saldo dalej jest poniżej progu, kolejne obciążenie karty nastąpi najwcześniej 6 godzin po poprzednim.

Jeżeli bank odrzuci obciążenie albo zażąda dodatkowego potwierdzenia, próba jest liczona jako nieudana. Dostaniesz e-mail, a my spróbujemy ponownie później. Po trzeciej nieudanej próbie z rzędu status zmienia się na **wyłączone po błędach** i wysyłamy osobną wiadomość.

> **Uwaga:** Gdy masz aktywne automatyczne doładowanie, nie wysyłamy e-maili ostrzegających o kończących się środkach. Jeśli karta wygaśnie lub zostanie zablokowana, sprawdzaj panel albo skrzynkę — informację o nieudanym obciążeniu dostaniesz e-mailem.

#### Zmiana ustawień

W karcie **Automatyczne doładowanie** możesz:

- zmienić próg i kwotę, a potem kliknąć **Zapisz**,
- wstrzymać doładowanie przełącznikiem **Doładowuj automatycznie** (karta zostaje zapisana, status: **wstrzymane**),
- kliknąć **Zmień kartę**, aby podać nową kartę (znów z pierwszą płatnością i potwierdzeniem w banku),
- kliknąć **Usuń kartę** — doładowanie zostanie wyłączone, a karta usunięta.

#### Po wyłączeniu z powodu błędów

1. Sprawdź kartę (ważność, limity, płatności internetowe/cykliczne w banku).
2. Jeśli karta jest w porządku, włącz przełącznik **Doładowuj automatycznie** i kliknij **Zapisz** — licznik błędów się wyzeruje.
3. Jeśli chcesz użyć innej karty, kliknij **Zmień kartę**.

Powiązane artykuły:

- [Doładowanie konta](../konto-i-rozliczenia/doladowanie-konta)
- [Jak liczymy koszty](../konto-i-rozliczenia/jak-liczymy-koszty)
- [Faktury](../konto-i-rozliczenia/faktury)

## Jak liczymy koszty

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/jak-liczymy-koszty

Rozliczenie godzinowe z limitem miesięcznym, hosting płatny z góry i co się dzieje, gdy saldo się skończy.

Wszystkie opłaty pobieramy z salda prepaid. Kwoty w panelu są netto. Są dwa sposoby naliczania: **godzinowy** (serwery i usługi chmurowe) oraz **z góry** (hosting i domeny).

#### Usługi godzinowe: serwery i chmura

Dotyczy serwerów VPS, baz danych, load balancerów, Kubernetes, RabbitMQ, aplikacji i innych zasobów chmurowych.

- Opłatę pobieramy **z góry za każdą rozpoczętą godzinę**, od utworzenia zasobu do jego usunięcia.
- **Limit miesięczny:** w miesiącu kalendarzowym opłaty za dany serwer nigdy nie przekroczą jego ceny miesięcznej z cennika. Po osiągnięciu limitu do końca miesiąca nie pobieramy już opłat za ten serwer.
- Stawka godzinowa to cena miesięczna podzielona przez `730` godzin (zaokrąglona w górę).

> **Uwaga:** Wyłączony serwer nadal zajmuje zasoby i jest rozliczany. Aby przestać płacić, usuń serwer. Przy usunięciu naliczanie kończy się od razu, ale bieżąca, opłacona godzina nie jest zwracana.

Przykład: serwer za `29 zł` miesięcznie, działający cały miesiąc, kosztuje dokładnie `29 zł`. Ten sam serwer utworzony na 10 godzin kosztuje 10 × stawka godzinowa.

Jeżeli utworzenie serwera nie powiedzie się z naszej winy, pobraną opłatę zwracamy na saldo. Zasoby w stanie błędu nie są rozliczane.

Niektóre dodatki rozliczamy według zużycia, np. kopie zapasowe serwerów w zależności od zajętego miejsca. Wszystkie pobrane kwoty widzisz w **Konto → Rozliczenia → Historia transakcji**.

#### Hosting i domeny: płatne z góry

- **Hosting** opłacasz z salda z góry za miesiąc albo rok. Na koniec okresu odnawiamy go automatycznie z salda.
- **Domeny** — rejestracja i odnowienie pobierane z salda za rok.

Dlatego saldo `0 zł` przy samym hostingu nie jest problemem — ważne, żeby przed końcem okresu były środki na odnowienie.

#### Gdy saldo się skończy

**Serwery i usługi godzinowe:**

1. Gdy środki wystarczą na mniej niż ok. 3 dni, wysyłamy e-mail z ostrzeżeniem.
2. Gdy saldo spadnie **poniżej zera**, serwery są zatrzymywane i **zawieszane**. W czasie zawieszenia opłaty nie są naliczane.
3. Na stronie **Przegląd** zobaczysz ostrzeżenie z terminem usunięcia.
4. Serwery zawieszone z powodu braku środków dłużej niż **7 dni** są **trwale usuwane wraz z danymi**.

**Hosting:**

1. Jeśli w dniu odnowienia na saldzie brakuje środków, hosting zostaje zawieszony.
2. Po **30 dniach** od końca opłaconego okresu konto hostingowe jest usuwane.

> **Uwaga:** Usunięcia z powodu braku środków nie da się cofnąć. Jeśli prowadzisz usługi produkcyjne, włącz [automatyczne doładowanie](../konto-i-rozliczenia/automatyczne-doladowanie).

#### Wznowienie po doładowaniu

Wystarczy [doładować konto](../konto-i-rozliczenia/doladowanie-konta):

- serwery zawieszone z braku środków są wznawiane i uruchamiane automatycznie zaraz po zaksięgowaniu wpłaty; przy wznowieniu pobieramy opłatę za pierwszą godzinę,
- serwery wznawiamy po kolei, dopóki saldo wystarcza na godzinę pracy kolejnego — doładuj kwotę, która pokryje wszystkie,
- zawieszony hosting odnawiamy z salda przy najbliższym rozliczeniu (sprawdzamy co godzinę).

#### Gdzie sprawdzić koszty

| Miejsce | Co pokazuje |
|---|---|
| Górny pasek | Aktualne saldo |
| **Przegląd** | Koszt w tym miesiącu i prognozę |
| **Rozliczenia** | Koszt na godzinę, prognozę miesięczną, czas, na jaki wystarczy saldo |
| Strona projektu | Łączny miesięczny koszt zasobów projektu |

Jeśli masz przyznany stały rabat, panel pokazuje kwoty już po rabacie, a cenę katalogową przekreśloną obok.

Powiązane artykuły:

- [Doładowanie konta](../konto-i-rozliczenia/doladowanie-konta)
- [Automatyczne doładowanie kartą](../konto-i-rozliczenia/automatyczne-doladowanie)
- [Faktury](../konto-i-rozliczenia/faktury)

## Faktury

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/faktury

Kiedy dostajesz fakturę, gdzie ją pobrać i jak zadbać o poprawne dane nabywcy.

Fakturę VAT wystawiamy za każde **doładowanie konta** — ręczne i automatyczne. Faktura dotyczy kwoty brutto płatności (kwota netto trafia na saldo, a do płatności doliczamy VAT). Opłaty pobierane później z salda za serwery, hosting czy domeny nie mają osobnych faktur — są już rozliczone fakturą za doładowanie.

#### Jak dostajesz fakturę

1. Doładowujesz konto i płatność zostaje zaksięgowana.
2. Dostajesz e-mail z potwierdzeniem doładowania.
3. Fakturę wystawiamy po zaksięgowaniu płatności i wysyłamy **osobną wiadomością** z plikiem PDF w załączniku.
4. Ta sama faktura pojawia się w panelu.

> **Wskazówka:** Akceptując Regulamin, zgadzasz się na otrzymywanie faktur w formie elektronicznej.

#### Gdzie pobrać fakturę

1. W menu wybierz **Konto → Rozliczenia**.
2. Przewiń do karty **Faktury**.
3. Przy wybranej fakturze kliknij **Pobierz PDF**.

Przy każdej fakturze widzisz numer, datę wystawienia i kwotę brutto. Oznaczenie **do zapłaty** pojawia się przy fakturze, która nie została jeszcze opłacona.

Jeśli karta jest pusta, zobaczysz komunikat *Brak faktur* — faktura pojawi się po zaksięgowaniu płatności i jej wystawieniu.

#### Dane nabywcy

Faktura jest wystawiana na dane z sekcji **Dane do faktury** w karcie **Doładuj konto**:

| Pole | Uwagi |
|---|---|
| Nazwa / firma | Nazwa firmy lub imię i nazwisko |
| NIP | Opcjonalnie — dla firm |
| Adres | Ulica i numer |
| Kod pocztowy, Miejscowość | Wymagane |
| Kraj | Domyślnie Polska |

Aby zapisać lub zmienić dane:

1. Wejdź w **Konto → Rozliczenia**.
2. Uzupełnij pola w sekcji **Dane do faktury**.
3. Kliknij **Zapisz dane do faktury** (nie wymaga płatności).

> **Uwaga:** Dane nabywcy zapisujemy razem z płatnością w chwili jej utworzenia. Zmiana danych w profilu działa dla kolejnych doładowań — nie zmienia faktury za płatność już wykonaną. Bez danych do faktury nie możemy jej wystawić, więc uzupełnij je przed pierwszym doładowaniem.

#### Błąd na fakturze lub brak faktury

Jeśli faktura zawiera błędne dane albo nie dotarła:

1. Sprawdź kartę **Faktury** w Rozliczeniach — może już tam być.
2. Sprawdź folder ze spamem w skrzynce.
3. Jeśli faktury dalej brakuje albo wymaga korekty, załóż zgłoszenie w **Konto → Wsparcie** i podaj datę oraz kwotę płatności.

#### Kto ma dostęp do faktur

Faktury widzi właściciel konta oraz członkowie zespołu z dostępem do całego konta, którym nie ukryto kwot. Osoby z ukrytymi kwotami lub ograniczone do jednego projektu nie widzą rozliczeń ani faktur. Więcej w artykule [Zespół i role](../konto-i-rozliczenia/zespol-i-role).

Powiązane artykuły:

- [Doładowanie konta](../konto-i-rozliczenia/doladowanie-konta)
- [Automatyczne doładowanie kartą](../konto-i-rozliczenia/automatyczne-doladowanie)
- [Jak liczymy koszty](../konto-i-rozliczenia/jak-liczymy-koszty)

## Zespół i role

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/zespol-i-role

Jak zaprosić współpracowników do konta, jakie są role, jak ukryć kwoty i ograniczyć dostęp do jednego projektu.

Do konta możesz zaprosić współpracowników — np. programistę, agencję albo księgową. Każda osoba loguje się na własne konto Hostava i własne hasło, a do Twoich zasobów przełącza się w panelu. Nie musisz nikomu podawać swojego hasła.

#### Role i zakres dostępu

Przy zaproszeniu ustawiasz trzy rzeczy:

| Ustawienie | Opcje | Co oznacza |
|---|---|---|
| Rola | **Podgląd** | Może tylko przeglądać zasoby, bez żadnych zmian |
| | **Edycja** | Może zarządzać zasobami: tworzyć, zmieniać, usuwać |
| Zakres | **Całe konto** | Dostęp do wszystkich zasobów konta |
| | **Tylko projekt: …** | Dostęp wyłącznie do zasobów jednego projektu |
| Kwoty | **Pokazuj kwoty** | Odznacz, aby osoba nie widziała cen, kosztów ani salda |

Osoba ograniczona do projektu widzi w menu tylko ten projekt i jego zasoby. Nie ma dostępu do rozliczeń, tokenów API, dziennika aktywności ani innych ustawień całego konta.

Osoba z odznaczonym **Pokazuj kwoty** nie widzi salda, cen, kosztów, pozycji **Rozliczenia** ani faktur. Wszystkie usługi, które utworzy, są rozliczane z Twojego salda.

#### Jak zaprosić osobę

1. Kliknij menu z inicjałami → **Mój profil**.
2. Przewiń do karty **Konto zespołu**.
3. Wpisz adres w polu **Zaproś do zespołu (e-mail)**.
4. Wybierz rolę (**Podgląd** lub **Edycja**) i zakres (**Całe konto** lub **Tylko projekt**).
5. Zaznacz lub odznacz **Pokazuj kwoty**.
6. Kliknij **Wyślij zaproszenie**.

Zaproszona osoba dostaje e-mail z linkiem ważnym **7 dni**. Jeśli ma już konto Hostava, loguje się i klika **Dołącz do zespołu**. Jeśli nie ma — zakłada konto na tej samej stronie (**Załóż konto i dołącz**). Po przyjęciu panel od razu przełącza ją na Twoje konto.

Oczekujące zaproszenia widzisz na liście **Oczekujące zaproszenia** — możesz je **Anulować**. Ponowne zaproszenie tego samego adresu zastępuje poprzednie.

#### Zmiana uprawnień i usuwanie

Na liście **Członkowie zespołu** możesz w każdej chwili zmienić rolę, zakres i widoczność kwot — zmiana działa od razu. Przycisk **Usuń** natychmiast odbiera dostęp, także jeśli ta osoba właśnie pracuje na Twoim koncie.

> **Uwaga:** Zespołem zarządza tylko właściciel konta, na swoim własnym koncie. Członek zespołu z rolą **Edycja** zarządza zasobami, ale nie może zapraszać ani usuwać innych osób.

#### Wymaganie 2FA od zespołu

W karcie **Konto zespołu** możesz włączyć **Wymagaj weryfikacji dwuetapowej od członków zespołu**. Osoba bez 2FA nie przełączy się na Twoje konto, dopóki jej nie włączy. Panel pokaże listę osób, które jeszcze nie mają 2FA.

Aby włączyć tę opcję, najpierw włącz [weryfikację dwuetapową](../konto-i-rozliczenia/weryfikacja-dwuetapowa) na własnym koncie.

#### Gdy to Ciebie zaproszono

Po dołączeniu w menu nad sekcją **Projekty** pojawi się przełącznik kont. Wybierz konto, na którym chcesz pracować — panel odświeży się w jego kontekście. Swoje konto wybierzesz w tym samym miejscu (**Twoje konto**). Przełączanie znajdziesz też w **Mój profil → Konto zespołu → Aktywne konto**.

> **Wskazówka:** Wszystkie działania członków zespołu są zapisywane w dzienniku **Konto → Aktywność** z adresem e-mail osoby, która je wykonała.

Powiązane artykuły:

- [Czym są projekty](../projekty-i-sieci/czym-sa-projekty)
- [Bezpieczeństwo konta](../konto-i-rozliczenia/bezpieczenstwo-konta)

## Weryfikacja dwuetapowa (2FA)

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/weryfikacja-dwuetapowa

Jak włączyć logowanie z kodem z aplikacji, jak używać kodów zapasowych i jak wyłączyć 2FA.

Weryfikacja dwuetapowa (2FA) to dodatkowe zabezpieczenie logowania. Poza hasłem podajesz 6-cyfrowy kod z aplikacji na telefonie, który zmienia się co 30 sekund. Nawet jeśli ktoś pozna Twoje hasło, bez telefonu się nie zaloguje.

Zalecamy włączenie 2FA każdemu, a szczególnie właścicielom kont z serwerami produkcyjnymi.

#### Czego potrzebujesz

Aplikacji uwierzytelniającej w telefonie lub menedżerze haseł, np. Google Authenticator, Microsoft Authenticator, Authy albo 1Password.

#### Jak włączyć 2FA

1. Kliknij menu z inicjałami w prawym górnym rogu → **Mój profil**.
2. Znajdź kartę **Uwierzytelnianie dwuskładnikowe (2FA)** i kliknij **Włącz 2FA**.
3. Zeskanuj wyświetlony kod QR w aplikacji. Jeśli nie możesz zeskanować, wpisz w aplikacji klucz pokazany obok kodu.
4. Wpisz 6-cyfrowy kod z aplikacji w polu **Kod z aplikacji**.
5. Kliknij **Włącz 2FA**.
6. **Zapisz kody zapasowe** (patrz niżej) i kliknij **Gotowe**.

Od teraz karta pokazuje status **włączone**.

> **Wskazówka:** Jeśli panel odrzuca poprawny kod, sprawdź, czy zegar w telefonie ustawia się automatycznie. Kody zależą od dokładnego czasu.

#### Kody zapasowe

Po włączeniu 2FA panel pokazuje **10 kodów zapasowych** w formacie `abcde-12345`.

- Każdy kod działa **tylko raz**.
- Pozwala zalogować się, gdy nie masz dostępu do aplikacji (np. zgubiony lub wymieniony telefon).
- Kody pokazujemy **tylko jeden raz** — skopiuj je przyciskiem i przechowuj w bezpiecznym miejscu, np. w menedżerze haseł.

> **Uwaga:** Nie da się później wyświetlić tych samych kodów ponownie. Jeśli je zgubisz, a masz jeszcze dostęp do aplikacji, wyłącz 2FA i włącz je od nowa — dostaniesz nowy zestaw kodów, a stare przestaną działać.

#### Logowanie z 2FA

1. Wpisz e-mail i hasło na stronie logowania.
2. Pojawi się pole **Kod uwierzytelniania (2FA)**.
3. Wpisz aktualny kod z aplikacji albo jeden z kodów zapasowych i kliknij **Potwierdź kod**.

Błędny kod jest liczony jako nieudana próba logowania. Jeśli masz włączone powiadomienia, dostaniesz e-mail o próbie logowania z poprawnym hasłem, ale błędnym kodem — to sygnał, że ktoś może znać Twoje hasło. Wtedy od razu zmień hasło.

#### Jak wyłączyć 2FA

1. Wejdź w **Mój profil** → karta **Uwierzytelnianie dwuskładnikowe (2FA)**.
2. Kliknij **Wyłącz 2FA**.
3. Podaj **Hasło** i aktualny **Kod 2FA** (albo kod zapasowy).
4. Potwierdź przyciskiem **Wyłącz 2FA**.

Po wyłączeniu wszystkie kody zapasowe przestają działać.

#### Zgubiłeś telefon i kody zapasowe

Jeśli nie masz ani aplikacji, ani żadnego kodu zapasowego, nie zalogujesz się samodzielnie — reset hasła nie wyłącza 2FA. Skontaktuj się z obsługą Hostava z adresu e-mail przypisanego do konta.

#### 2FA w zespole

Właściciel konta może wymagać 2FA od wszystkich członków zespołu. Jeśli jesteś członkiem cudzego zespołu i przy przełączaniu konta widzisz oznaczenie **wymaga 2FA**, włącz weryfikację dwuetapową na swoim koncie, a potem przełącz się ponownie. Szczegóły w artykule [Zespół i role](../konto-i-rozliczenia/zespol-i-role).

Powiązane artykuły:

- [Bezpieczeństwo konta](../konto-i-rozliczenia/bezpieczenstwo-konta)
- [Jak założyć konto](../pierwsze-kroki/zalozenie-konta)

## Bezpieczeństwo konta

Adres: https://pomoc.hostava.pl/konto-i-rozliczenia/bezpieczenstwo-konta

Aktywne sesje, powiadomienia o logowaniu, dziennik aktywności, zmiana hasła i lista kontrolna bezpieczeństwa.

W panelu masz kilka narzędzi, które pomagają chronić konto i szybko zauważyć nieautoryzowany dostęp. Najważniejsze z nich to [weryfikacja dwuetapowa](../konto-i-rozliczenia/weryfikacja-dwuetapowa) — włącz ją w pierwszej kolejności.

#### Aktywne sesje

Karta **Aktywne sesje** w **Mój profil** (menu z inicjałami) pokazuje urządzenia, na których jesteś zalogowany:

- nazwę przeglądarki i systemu (albo nazwę, którą nadasz),
- adres IP,
- kiedy sesja była ostatnio aktywna i kiedy się zalogowałeś,
- oznaczenie **to urządzenie** przy bieżącej sesji.

Co możesz zrobić:

1. Kliknąć ikonę ołówka, aby nadać sesji nazwę, np. „Laptop służbowy”.
2. Kliknąć **Wyloguj** przy sesji, której nie rozpoznajesz.
3. Kliknąć **Wyloguj pozostałe**, aby zakończyć wszystkie sesje poza bieżącą.

Sesja wygasa po 14 dniach — potem trzeba zalogować się ponownie.

> **Uwaga:** Jeśli widzisz sesję, której nie rozpoznajesz, wyloguj ją i od razu zmień hasło. Zmiana hasła automatycznie wylogowuje wszystkie pozostałe sesje.

#### Zmiana hasła

1. Wejdź w **Mój profil** → karta **Zmiana hasła**.
2. Podaj **Obecne hasło**, **Nowe hasło** (min. 8 znaków, inne niż obecne) i powtórz je.
3. Kliknij **Zmień hasło**.

Po zmianie pozostałe zalogowane sesje zostaną wylogowane — bieżąca zostaje. Jeśli nie pamiętasz obecnego hasła, wyloguj się i użyj opcji **Nie pamiętasz hasła?** na stronie logowania; po takim resecie wylogowujemy wszystkie sesje i wysyłamy e-mail z potwierdzeniem zmiany.

#### Powiadomienia o logowaniu

W karcie **Powiadomienia** w **Mój profil** możesz włączyć lub wyłączyć:

| Przełącznik | Kiedy wysyłamy e-mail |
|---|---|
| Informuj mnie o każdym logowaniu do konta | Przy każdym logowaniu — z czasem, adresem IP i urządzeniem. Logowanie z nowego adresu IP jest wyraźnie oznaczone |
| Informuj mnie o nieudanych próbach logowania | Przy błędnym haśle albo błędnym kodzie 2FA — z adresem IP. Przy wielu próbach: jedna wiadomość na 15 minut z ich liczbą |
| Informuj mnie o problemach z usługami | Gdy nie uda się utworzyć usługi, gdy usługa przestanie działać i gdy wróci do sprawności |

Domyślnie wszystkie są włączone. Wiadomości o płatnościach, zmianie hasła i incydentach bezpieczeństwa wysyłamy zawsze.

> **Wskazówka:** E-mail o błędnym kodzie 2FA oznacza, że ktoś podał **poprawne hasło**. Jeśli to nie Ty, natychmiast zmień hasło i wyloguj pozostałe sesje.

#### Ochrona przed zgadywaniem hasła

Po 10 nieudanych próbach logowania na jeden adres e-mail w ciągu 15 minut logowanie jest czasowo blokowane. Podobny limit obowiązuje dla jednego adresu IP.

#### Dziennik aktywności

**Konto → Aktywność** to historia działań na Twoim koncie — z panelu, API i automatycznych procesów systemu: logowania, tworzenie i usuwanie serwerów, zmiany w zespole, tokenach API, płatności i wiele innych. Przy każdym wpisie widzisz, kto wykonał działanie. Działania naszej obsługi na Twoim koncie są widoczne pod etykietą **Obsługa**.

Kliknij **Załaduj starsze**, aby zobaczyć wcześniejsze wpisy.

#### Lista kontrolna bezpieczeństwa

Strona **Konto → Bezpieczeństwo** zawiera:

- **Listę kontrolną** — które zabezpieczenia (np. kopie zapasowe, kontrola dostępu, logi) masz już włączone, a których brakuje i na których serwerach. Przydatna, jeśli Twoja firma podlega przepisom NIS2.
- **Dokument dla oceny dostawcy** — opis naszych zabezpieczeń do pobrania (DOCX), np. do dokumentacji NIS2 lub RODO.

#### Dobre praktyki

1. Włącz 2FA i zapisz kody zapasowe.
2. Używaj unikalnego hasła z menedżera haseł.
3. Nie udostępniaj swojego hasła — współpracowników [zaproś do zespołu](../konto-i-rozliczenia/zespol-i-role).
4. Do skryptów używaj [tokenów API](../api/tokeny-api) z ograniczonym zakresem i terminem ważności.
5. Co jakiś czas przejrzyj aktywne sesje i dziennik aktywności.

# API

## Tokeny API

Adres: https://pomoc.hostava.pl/api/tokeny-api

Jak wygenerować token do API, jaki wybrać zakres i ważność oraz jak bezpiecznie przechowywać i unieważniać tokeny.

Token API pozwala Twoim skryptom, systemom CI czy narzędziom typu Terraform zarządzać zasobami konta bez logowania do panelu. Token przekazujesz w nagłówku `Authorization` każdego żądania.

#### Jak wygenerować token

1. W menu wybierz **Dla programistów → Tokeny API**.
2. Kliknij **Generuj token**.
3. Wpisz **Nazwę**, która powie Ci, do czego służy token, np. `terraform` albo `ci-deploy`.
4. Wybierz **Zakres** i **Ważność** (patrz niżej).
5. Kliknij **Generuj**.
6. **Skopiuj token od razu** i zapisz go w bezpiecznym miejscu, np. w menedżerze haseł lub sekretach CI.
7. Kliknij **Zapisałem, ukryj**.

> **Uwaga:** Pełny token pokazujemy **tylko raz**. Na liście zostaje jedynie jego początek, np. `hv_Xk3p9a…`. Jeśli zgubisz token, unieważnij go i wygeneruj nowy.

#### Zakres

| Zakres | Co pozwala |
|---|---|
| **Odczyt i zapis** | Pełne zarządzanie: tworzenie, zmiany i usuwanie zasobów |
| **Tylko odczyt** | Tylko żądania `GET` — listy, szczegóły, metryki, rozliczenia |

Token **Tylko odczyt** przy próbie zmiany dostanie błąd `403` z komunikatem *Token API ma uprawnienia tylko do odczytu*.

> **Wskazówka:** Do monitoringu, raportów i dashboardów używaj tokenu **Tylko odczyt**. Token z zapisem dawaj tylko tym systemom, które naprawdę muszą coś zmieniać.

#### Ważność

Do wyboru: **30 dni**, **90 dni** (domyślnie), **1 rok** albo **Bezterminowo**. Po upływie ważności API odpowiada błędem `401` (*Nieprawidłowy lub wygasły token API*). Datę wygaśnięcia widzisz w kolumnie **Wygasa**.

Ważności tokenu nie da się przedłużyć — przed terminem wygeneruj nowy token, podmień go w swoich systemach i unieważnij stary.

#### Lista tokenów

Na stronie **Tokeny API** widzisz wszystkie tokeny z:

- nazwą i początkiem tokenu,
- zakresem (**Odczyt** albo **Odczyt i zapis**),
- **Ostatnim użyciem** — przydatne, by wykryć nieużywane tokeny,
- datą wygaśnięcia.

Na jednym koncie możesz mieć do **50 tokenów**.

#### Unieważnienie tokenu

1. Kliknij ikonę kosza przy tokenie.
2. Potwierdź przyciskiem **Unieważnij**.

Aplikacje używające tego tokenu tracą dostęp **natychmiast**. Unieważnij token od razu, jeśli mógł wyciec (np. trafił do repozytorium Git).

#### Ważne zasady

- Token działa w imieniu konta, na którym go utworzono, i ma dostęp do wszystkich jego zasobów.
- Tokenem nie utworzysz kolejnego tokenu — nowe tokeny tworzy się wyłącznie w panelu.
- Token nie daje dostępu do konsoli serwera w przeglądarce.
- Każde działanie wykonane tokenem trafia do dziennika **Konto → Aktywność** z oznaczeniem, że pochodzi z API.
- Członkowie zespołu ograniczeni do jednego projektu nie mają dostępu do tokenów API. Osoby z rolą **Podgląd** mogą tylko przeglądać listę.

#### Dobre praktyki

1. Jeden token na jedną aplikację lub system — łatwiej go potem unieważnić.
2. Ustaw jak najkrótszą rozsądną ważność.
3. Nie wpisuj tokenu w kod — trzymaj go w zmiennej środowiskowej, np. `HOSTAVA_TOKEN`.
4. Regularnie usuwaj tokeny, które od dawna nie były używane.

Powiązane artykuły:

- [Pierwsze kroki z API](../api/pierwsze-kroki-z-api)
- [Bezpieczeństwo konta](../konto-i-rozliczenia/bezpieczenstwo-konta)

## Pierwsze kroki z API

Adres: https://pomoc.hostava.pl/api/pierwsze-kroki-z-api

Pierwsze wywołania REST API Hostava z curl — sprawdzenie konta, katalog, utworzenie serwera i obsługa błędów.

Wszystko, co zrobisz w panelu, zrobisz też przez REST API: serwery, projekty, klucze SSH, bazy danych, load balancery, Kubernetes, Storage S3, VPN i rozliczenia. Pełny opis wszystkich operacji znajdziesz w [dokumentacji API](https://cloud.hostava.pl/docs/api) (menu **Dla programistów → Dokumentacja API**).

#### Zanim zaczniesz

1. Wygeneruj token w **Dla programistów → Tokeny API** — zobacz [Tokeny API](../api/tokeny-api).
2. Sprawdź **adres bazowy API** — jest podany na początku dokumentacji API oraz w przykładzie na stronie **Tokeny API**.
3. Zapisz oba w zmiennych środowiskowych:

```
export HOSTAVA_TOKEN="hv_…"
export HOSTAVA_API="https://api-prod.hostava.pl"
```

Podstawowe zasady:

- dane wysyłasz i odbierasz w formacie JSON,
- kwoty są w złotych netto, daty w formacie ISO 8601 (UTC),
- token przekazujesz w nagłówku `Authorization: Bearer <token>`.

#### Krok 1. Sprawdź, czy token działa

```
curl -H "Authorization: Bearer $HOSTAVA_TOKEN" $HOSTAVA_API/auth/me
```

W odpowiedzi dostaniesz dane konta, w tym saldo (`balance`).

#### Krok 2. Pobierz katalog

```
curl -H "Authorization: Bearer $HOSTAVA_TOKEN" $HOSTAVA_API/catalog
```

Katalog zawiera dostępne lokalizacje (`locations`), plany (`plans`) i obrazy systemów (`images`). Z niego bierzesz nazwę lokalizacji oraz `planId` i `imageId`.

> **Wskazówka:** Plany i obrazy mogą się zmieniać — nie zapisuj ich identyfikatorów na sztywno bez sprawdzenia katalogu.

#### Krok 3. Lista serwerów i kluczy SSH

```
curl -H "Authorization: Bearer $HOSTAVA_TOKEN" $HOSTAVA_API/servers
curl -H "Authorization: Bearer $HOSTAVA_TOKEN" $HOSTAVA_API/ssh-keys
```

Listę serwerów możesz filtrować parametrami `project` (ID projektu), `tag` i `q` (szukanie po nazwie i adresach IP).

#### Krok 4. Utwórz serwer

```
curl -X POST -H "Authorization: Bearer $HOSTAVA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"hostname":"web-01","location":"Warszawa","planId":1,"imageId":1,"sshKeyIds":[1],"tags":["web"]}' \
  $HOSTAVA_API/servers
```

Wymagane są `hostname`, `location`, `planId`, `imageId` oraz `sshKeyIds` albo `password`. Opcjonalnie podasz `projectId` — bez niego serwer trafi do projektu domyślnego.

Odpowiedź przychodzi od razu ze statusem `provisioning`. Serwer jest gotowy, gdy `status` zmieni się na `running` — zwykle w niecałą minutę. Sprawdzisz to tak:

```
curl -H "Authorization: Bearer $HOSTAVA_TOKEN" $HOSTAVA_API/servers/42
```

> **Uwaga:** Utworzenie serwera od razu pobiera z salda opłatę za pierwszą godzinę. Jeśli saldo jej nie pokrywa, API zwróci błąd `400`. Jeśli tworzenie się nie powiedzie (`status: error`), opłatę zwracamy.

#### Krok 5. Zarządzaj zasilaniem

```
curl -X POST -H "Authorization: Bearer $HOSTAVA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"reboot"}' $HOSTAVA_API/servers/42/power
```

Dostępne akcje: `start`, `shutdown`, `reboot`, `reset`, `stop`. Operacje na serwerze są asynchroniczne — trwającą operację widać w polu `currentTask`. Na serwerze może trwać tylko jedna operacja naraz.

#### Kody błędów

Błąd zawsze ma postać `{ "error": "…" }` z komunikatem po polsku.

| Kod | Znaczenie |
|---|---|
| `400` | Błąd walidacji lub warunku, np. brak środków |
| `401` | Brak tokenu, token nieprawidłowy lub wygasły |
| `403` | Token tylko do odczytu albo konto zawieszone |
| `404` | Zasób nie istnieje lub nie należy do Twojego konta |
| `409` | Konflikt — np. na serwerze trwa inna operacja |

#### Specyfikacja OpenAPI

Na stronie dokumentacji API kliknij **OpenAPI**, aby pobrać specyfikację w formacie OpenAPI 3.1. Zaimportujesz ją do Postmana lub Insomnii albo wygenerujesz z niej klienta SDK w swoim języku.

Powiązane artykuły:

- [Tokeny API](../api/tokeny-api)
- [Jak liczymy koszty](../konto-i-rozliczenia/jak-liczymy-koszty)
- [Czym są projekty](../projekty-i-sieci/czym-sa-projekty)