---
title: Rýchly štart
description: Spustite Accquix Register cez docker compose, počkajte na prvú synchronizáciu a pošlite prvé vyhľadávanie a overenie.
---

Potrebujete Docker s doplnkom compose, približne 10 GB voľného miesta a odchádzajúce HTTPS spojenie. Prvá
synchronizácia stiahne asi 1 GB a trvá 7–20 minút, väčšinu času zaberie sťahovanie.

**Alebo nechajte svojho AI agenta register **spustiť** lokálne a overiť, že funguje.**

> Spusti Accquix Register lokálne cez docker compose a over, že funguje. Súbory compose ani databázu nemeň.
>
> 1. Over, že je nainštalovaný Docker s doplnkom compose, že je voľných asi 10 GB na disku a že funguje odchádzajúce HTTPS.
> 2. Spusti `git clone https://github.com/accquix/register` a potom `./make-secrets.sh` v `register/deploy/compose`. Vypíše API kľúč len raz: povedz mi, aby som si ho uložil, a nikde inde ani do logov ho nezapisuj.
> 3. Spusti `docker compose up -d`. Prvá synchronizácia stiahne asi 1 GB a trvá 7–20 minút. Kým neskončí, API odpovedá `503` s dôvodom `bootstrapping`: to je očakávané, nie chyba.
> 4. Raz za minútu skontroluj `curl -s localhost:8080/readyz`, kým neodpovie `ready`. Ak nie je pripravený ani po 40 minútach, ukáž mi `docker compose logs --tail 50 sync`.
> 5. S kľúčom spusti jedno vyhľadávanie, `GET /v1/search?q=<názov firmy>`, a jedno overenie IČO z výsledku, `GET /v1/lookup/<IČO>`. Ukáž mi odpovede s ich `dataAsOf` a `attribution`.

## Vyskúšajte demo

Ak chcete API vidieť skôr, než čokoľvek stiahnete, spustite demo: skutočné API nad asi 180 fiktívnymi firmami a
živnostníkmi, s platiteľmi DPH, skupinou DPH, zaniknutými subjektmi aj záznamami v rizikových zoznamoch. Keď je obraz
zostavený, je pripravené za pár sekúnd.

```sh
git clone https://github.com/accquix/register && cd register
docker compose -f deploy/demo/compose.yaml up -d --wait serve
curl -s 'localhost:8080/v1/search?q=zlata'
```

API kľúč netreba: demo počúva len na localhoste. Každá odpoveď má v `attribution` text `DEMO DATA` a
`/v1/capabilities` uvádza `"demo": true`. Databáza je len v pamäti a po
`docker compose -f deploy/demo/compose.yaml down` zmizne. Synchronizácia demo databázu odmietne, takže demo a reálne
dáta sa nikdy nezmiešajú.

## Spustenie s reálnymi dátami

1. **Stiahnite kód**

    ```sh
    git clone https://github.com/accquix/register
    cd register/deploy/compose
    ```

2. **Vytvorte tajomstvá**

    ```sh
    ./make-secrets.sh
    ```
    Skript zapíše náhodné heslo k databáze a jeden kľúč API do priečinka `secrets/`. **Kľúč API sa zobrazí iba
    raz:** uložte si ho hneď. Uchováva sa len jeho odtlačok SHA-256.

3. **Spustite služby**

    ```sh
    docker compose up -d
    ```
    Compose spustí PostgreSQL 18, aplikuje schému (`migrate`) a potom spustí API (`serve`) a hodinovú
    synchronizáciu (`sync --every 1h`).

4. **Počkajte na prvú synchronizáciu**

    ```sh
    docker compose logs -f sync
    curl -s localhost:8080/readyz
    ```
    Kým nie sú zverejnené všetky zdroje, API odpovedá `503` s dôvodom `bootstrapping`. Keď synchronizácia zapíše
    `fs list applied` pre posledný zoznam, `/readyz` odpovie `ready`.

5. **Vyhľadajte a overte**

    ```sh
    export KEY=<váš kľúč>
    curl -s -H "Authorization: Bearer $KEY" "localhost:8080/v1/search?q=zlata%20ryb"
    curl -s -H "Authorization: Bearer $KEY" "localhost:8080/v1/lookup/99900001"
    ```

Vyhľadávanie vráti kandidátov, overenie podľa identifikátora vráti celý subjekt:

```json title="GET /v1/search?q=zlata ryb"
{
  "mode": "default",
  "results": [
    {
      "ico": "99900001",
      "name": "Zlatá Rybka, s.r.o.",
      "municipality": "Fiktívne Mesto",
      "kind": "legal_person",
      "active": true
    }
  ],
  "dataAsOf": "2026-11-10",
  "attribution": [
    "Register právnických osôb, Ministerstvo vnútra SR, CC BY 4.0",
    "Zdroj údajov: Finančná správa SR"
  ]
}
```

:::tip
Príklady na tomto webe používajú vymyslené subjekty, napríklad „Zlatá Rybka, s.r.o.“ s IČO `99900001`. Vaša
inštancia vracia skutočné údaje z registrov.
:::

## Ďalej

- [Ako to funguje](/sk/concepts/how-it-works): čo robí synchronizácia a čo odpovede garantujú.
- [Práca s API](/sk/api/search): vyhľadávanie, overenie a sledovanie zmien.
- [Vlastná prevádzka](/sk/self-hosting/requirements): požiadavky, databázové roly, monitorovanie a aktualizácie.