> ## Documentation Index
> Fetch the complete documentation index at: https://docs-beta.new-host.net/llms.txt
> Use this file to discover all available pages before exploring further.

# txAdmin - Pierwsza Konfiguracja

> Krok po kroku skonfiguruj txAdmin

# Pierwsza Konfiguracja txAdmin

Przeprowadzę Cię przez pełną konfigurację txAdmin od zera.

## Pierwsze Uruchomienie

<Steps>
  <Step title="Uruchom Serwer">
    Panel NEW-HOST → **"Start"**
  </Step>

  <Step title="Otwórz Konsolę">
    Zakładka **"Konsola"**
  </Step>

  <Step title="Znajdź Link i PIN">
    ```
    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
    ┃                                    ┃
    ┃     All ready! Please access:      ┃
    ┃      https://d8cfd7a2.nhtx.pl      ┃
    ┃                                    ┃
    ┃   Use the PIN below to register:   ┃
    ┃                7224                ┃
    ┃                                    ┃
    ┃                                    ┃
    ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
    ```
  </Step>

  <Step title="Zapisz Dane">
    Skopiuj URL i PIN
  </Step>
</Steps>

## Logowanie do txAdmin

<Steps>
  <Step title="Otwórz Link">
    Wklej URL w przeglądarce - zobaczysz ekran **"No Cfx.re account linked"**
  </Step>

  <Step title="Wprowadź PIN">
    Wpisz PIN z konsoli (4 cyfry w każdym polu)
  </Step>

  <Step title="Link Account">
    Kliknij **"Link Account"**
  </Step>

  <Step title="Login with Cfx.re">
    Zaloguj się kontem Cfx.re
  </Step>

  <Step title="Utwórz Hasło Backup">
    Wprowadź **Discord ID** (opcjonalnie) oraz ustaw **Backup Password** (6-128 cyfr) i potwierdź je
  </Step>

  <Step title="Akceptuj Licencje">
    Zaznacz checkbox: "I have read and agree to the Creator PLA as well as the txAdmin License"
  </Step>

  <Step title="Register">
    Kliknij **"Register"**
  </Step>
</Steps>

## Kreator Konfiguracji - Krok 1: Nazwa Serwera

<Steps>
  <Step title="Ekran powitalny">
    Po zalogowaniu zobaczysz **"Step 1: Server Name"**
  </Step>

  <Step title="Wprowadź nazwę">
    Wpisz krótką nazwę serwera (np. "change-me") - będzie używana w interfejsie txAdmin i wiadomościach Chat/Discord
  </Step>

  <Step title="Przejdź dalej">
    Kliknij **"Next"**
  </Step>
</Steps>

## Kreator Konfiguracji - Krok 2: Typ Wdrożenia

txAdmin oferuje kilka opcji konfiguracji serwera:

### Popular Recipes (Zalecane)

Wybierz szablon z gotowych frameworków - najłatwiejsza opcja dla początkujących:

* **FiveM Basic Server (CFX Default)** - Minimalny serwer bez frameworka
* **ESX Legacy** - Popularny framework RP z jobami, pojazdami i housing
* **Qbox** - Nowoczesny framework zoptymalizowany
* **QBCore** - Zaawansowany framework RP z gangami i housing
* **RedM Basic Server** - Dla serwerów RedM
* **VORP Core** - Framework RedM z różnymi jobami

<Tip>
  Jeśli dopiero zaczynasz - wybierz **Popular Recipes** i **ESX Legacy** lub **FiveM Basic Server**!
</Tip>

### Existing Server Data

Użyj istniejących plików serwera z folderu na hoście - wybierz tę opcję gdy masz już folder `server.cfg` i `resources`.

<Warning>
  Wybieraj tylko jeśli masz folder `server.cfg` i `resources` - w przeciwnym razie txserver nie będzie działać poprawnie.
</Warning>

### Remote URL Template

Załaduj konfigurację z Recipe w formacie YAML z zewnętrznego URL - możesz edytować Recipe przed uruchomieniem.

### Custom Template

Stwórz własną konfigurację - zalecane dla zaawansowanych użytkowników lub własnych receptur.

## Instalacja przez Popular Recipe (ESX Przykład)

<Steps>
  <Step title="Wybierz Popular Recipes">
    Kliknij **"Popular Recipes"**
  </Step>

  <Step title="Kliknij Back jeśli trzeba">
    Jeśli chcesz wrócić, użyj przycisku **"Back"**
  </Step>

  <Step title="Wybierz Template">
    Po przejściu dalej zobaczysz **"Step 3: Select Template"** - wybierz **"ESX Legacy"**
  </Step>

  <Step title="Przejdź do Recipe">
    Kliknij **"Next"** (lub odpowiedni przycisk nawigacji)
  </Step>
</Steps>

## Recipe Deployer - Przegląd i Parametry

<Steps>
  <Step title="Step 1: Review Recipe">
    txAdmin pokaże listę zadań do wykonania: pobieranie z GitHub, usuwanie ścieżek, pobieranie plików, rozpakowywanie, łączenie z bazą, zapytania SQL itp.
  </Step>

  <Step title="Zatwierdź Recipe">
    Kliknij **"Next"** przy **"Step 1: Review Recipe ✓"**
  </Step>

  <Step title="Step 2: Input Parameters">
    Wprowadź wymagane parametry:

    * **Server Registration Key** - Wklej klucz licencyjny z [Cfx.re Portal](https://keymaster.fivem.net/):
      ```
      cfxk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxx
      ```

    **Opcje bazy danych (zaawansowane)**:

    * Kliknij **"Show/Hide Database options (advanced)"** jeśli chcesz dostosować
    * **Database Host** - Host bazy danych
    * **Database Port** - Port (zazwyczaj 3306)
    * **Database Username** - Nazwa użytkownika bazy
    * **Database Password** - Hasło do bazy
    * **Database Name** - Nazwa bazy danych
    * **Delete Database** - Przełącznik OFF/ON - usuwa istniejącą bazę o tej samej nazwie
  </Step>

  <Step title="Run Recipe">
    Kliknij **"Run Recipe"**
  </Step>
</Steps>

<Warning>
  Włączenie **"Delete Database"** usunie wszystkie dane z istniejącej bazy o podanej nazwie!
</Warning>

## Proces Instalacji - Step 3: Run Recipe

txAdmin automatycznie wykonuje wszystkie zadania.

Komunikaty w konsoli Recipe Deployer (przykład FiveM Basic):

```
[17:05:13] Starting deployment of FiveM Basic Server.
[17:05:13] Running [task1:download_github]... ✓
[17:05:14] Running [task2:remove_path]... ✓
[17:05:14] Running [task3:download_file]... ✓
[17:05:14] All tasks completed.
[17:05:14] Replacing all vars in server.cfg... ✓
[17:05:14] Deploy finished and folder validated. All done!
```

Komunikaty dla ESX Legacy (więcej zadań):

```
[17:13:26] Starting deployment of ESX Legacy.
[17:13:26] Running [task1:download_github]... ✓
[17:13:27] Running [task2:remove_path]... ✓
[17:13:27] Running [task3:download_github]... ✓
[17:13:28] Running [task4:move_path]... ✓
[17:13:28] Running [task5:move_path]... ✓
[17:13:28] Running [task6:connect_database]... ✓
[17:13:28] Running [task7:download_github]... ✓
[17:13:30] Running [task8:query_database]... ✓
[17:13:31] Running [task9:download_github]... ✓
[17:13:34] Running [task10:move_path]... ✓
[17:13:34] Running [task11:move_path]... ✓
[17:13:34] Running [task12:download_github]... ✓
[17:13:35] Running [task13:download_github]... ✓
[17:13:36] Running [task14:download_file]... ✓
[17:13:37] Running [task15:unzip]... ✓
[17:13:37] Running [task16:remove_path]... ✓
[17:13:37] All tasks completed.
[17:13:37] Replacing all vars in server.cfg... ✓
[17:13:37] Deploy finished and folder validated. All done!
```

<Info>
  Instalacja zajmuje od 30 sekund (FiveM Basic) do 5 minut (ESX Legacy, QBCore) w zależności od recipe
</Info>

<Steps>
  <Step title="Poczekaj na ukończenie">
    Pasek postępu pokaże **"DONE"** po zakończeniu
  </Step>

  <Step title="Kliknij Next">
    Przycisk **"Next"** pojawi się po ukończeniu instalacji
  </Step>
</Steps>

## Step 3: Configure server.cfg (Opcjonalnie)

Po instalacji możesz dostosować `server.cfg` bezpośrednio w txAdmin, ale zazwyczaj nie jest to konieczne - serwer jest gotowy do uruchomienia.

<Steps>
  <Step title="Edytuj server.cfg">
    Możesz teraz edytować konfigurację serwera jeśli chcesz dostosować nazwę, liczbę graczy, tagi itp.
  </Step>

  <Step title="Zapisz i uruchom">
    Kliknij **"Save & Run Server"** lub **"Next"** aby przejść do dashboardu
  </Step>
</Steps>

## Dashboard txAdmin

Po zakończeniu konfiguracji txAdmin przekieruje do głównego panelu zarządzania:

* **Server Status** - Status serwera (OFFLINE/ONLINE)
* **Uptime** - Czas działania serwera
* **Whitelist** - Status whitelisty (DISABLED/ENABLED)
* **Discord Bot** - Status bota Discord (DISABLED/ENABLED)
* **Next Restart** - Zaplanowany restart (nothing scheduled)

## Pierwsze Uruchomienie Serwera

<Steps>
  <Step title="Dashboard">
    W dashboardzie zobaczysz status **"Server: OFFLINE"**
  </Step>

  <Step title="Start Server">
    Kliknij **"Start"** w sekcji Server controls lub użyj menu bocznego
  </Step>

  <Step title="Live Console">
    Przejdź do **"Live Console"** i obserwuj proces startowania serwera
  </Step>

  <Step title="Sprawdź Status">
    Po starcie status zmieni się na **"ONLINE"** z zielonym oznaczeniem
  </Step>
</Steps>

## Testowanie Serwera

<Steps>
  <Step title="Otwórz FiveM Client">
    Uruchom FiveM na komputerze
  </Step>

  <Step title="Konsola F8">
    W głównym menu naciśnij **F8**
  </Step>

  <Step title="Connect">
    Wpisz (użyj swojego IP z panelu):

    ```
    connect 89.168.81.234:30155
    ```

    Lub subdomenę jeśli utworzyłeś:

    ```
    connect mojserwer.nhsrv.pl
    ```
  </Step>

  <Step title="Testuj">
    Sprawdź czy wszystko działa poprawnie
  </Step>
</Steps>

## Następne Kroki

<CardGroup cols={2}>
  <Card title="Recipe System" icon="book" href="/fivem/txadmin/recipes">
    Poznaj dostępne frameworki i szablony
  </Card>

  <Card title="Zarządzanie Zasobami" icon="box" href="/fivem/txadmin/resources">
    Instaluj dodatkowe skrypty i resources
  </Card>

  <Card title="Discord Bot" icon="discord" href="/fivem/txadmin/discord-bot">
    Zaawansowana konfiguracja bota Discord
  </Card>

  <Card title="Automatyczne Restarty" icon="clock" href="/fivem/txadmin/scheduling">
    Skonfiguruj harmonogram restartów
  </Card>
</CardGroup>