# Coolify a Claude Code: Nasadenie projektu na vlastný VPS > Inštalácia Coolify, pripojenie GitHubu, nasadenie Next.js, doména a HTTPS, MCP, požiadavky na VPS a riešenie problémov. Technické ceny v dolároch a pôvodné obmedzenia. Source: https://ailoot.ai/blog/sk/coolify-claude-code-deploy/ Canonical: https://ailoot.ai/blog/sk/coolify-claude-code-deploy/ Language: sk Publisher: Ailoot (https://ailoot.ai/) Translation: guide-087 Revision: sha256-2be00327f38cf5d0517d463425c5892790c85c490dcdb45e259382f5658be831
[Dokumentácia Ailoot](https://ailoot.ai/docs/) — referenčné materiály na prácu so službou.
## Obmedzenia platformy a podmienky platieb v roku 2026
Hlavný bod Bezplatné programy fungujú, kým prvýkrát neprekročíte limit; potom je potrebná medzinárodná karta. Heroku v roku 2022 zrušilo bezplatnú úroveň pre všetkých a vo februári 2026 prešlo do režimu údržby. Pri vlastnom hostingu Coolify vlastníte server; neplatí sa za jednotlivé používateľské miesta a nie ste viazaní na dodávateľa.
Typický scenár vibe codera v roku 2026: za večer vytvoríte MVP v Cursor alebo Claude Code, presuniete ho do repozitára GitHub, otvoríte vercel.com → pripojíte repozitár → dostanete sa na obrazovku predplatného → zadáte kartu → zobrazí sa `Transaction declined`. Nie je to chyba ani dočasný výpadok. Railway, Render, Heroku — rovnaký príbeh. Heroku skutočne zrušilo bezplatnú úroveň pre všetkých v roku 2022 a vo februári 2026 projekt prešiel do režimu údržby — bez nových funkcií a nových zmlúv Enterprise. Pre používateľa s nepodporovanou kartou to znamená: „dvere sú zatvorené; obíďte to cez sprostredkovateľa, ktorý si účtuje 20 % províziu“. Platiť môžete cez virtuálne karty Visa v Kazachstane alebo firemné platobné služby. To môže znamenať dodatočné poplatky, čas na každú transakciu a riziko zablokovania účtu pri nesúlade krajiny. Pôvodný príklad zahŕňal tri pokusy — na Vercel Pro, Railway a Render. ## Čo je Coolify a ako funguje platforma s vlastným hostingom?
Hlavný bod Coolify je open-source PaaS, ktorý môžete hostovať sami, a priama alternatíva k Heroku, Vercel a Netlify. Nainštaluje sa jediným príkazom curl na ľubovoľnom VPS s Ubuntu. V pozadí používa Docker + Traefik na reverzné proxy a Let's Encrypt na HTTPS. Podporuje integráciu s GitHubom, webhooky na automatické nasadzovanie, zálohy S3 a viac než 280 služieb inštalovateľných jedným kliknutím (PostgreSQL, Redis, MinIO). Verzia s vlastným hostingom je navždy bezplatná, bez limitov. Na GitHube má 55,800 hviezdičiek a licenciu Apache-2.0.
Coolify je open-source projekt vytvorený pomocou Laravel + Docker, ktorý z ľubovoľného prázdneho VPS urobí platformu na nasadzovanie aplikácií. Coolify nainštalujete raz a všetko ostatné potom spravujete cez webové rozhranie: pripojíte GitHub, vyberiete repozitár a kliknete na Deploy. Oficiálna dokumentácia to vystihuje stručne a presne:

Coolify je open-source alternatíva s vlastným hostingom k Heroku / Netlify / Vercel atď.

— Coolify GitHub README, https://github.com/coollabsio/coolify
Coolify sa v pozadí skladá zo štyroch častí: 1. **Webové rozhranie vytvorené pomocou Laravel 12 + Livewire 3 + Tailwind v4** — informačný panel na správu aplikácií. 2. **Docker + Docker Compose** — každá aplikácia beží v kontajneri izolovanom od ostatných. 3. **Reverzné proxy (Traefik alebo Caddy)** — prijíma prichádzajúcu prevádzku HTTP/HTTPS a smeruje ju do kontajnerov. 4. **Integrácia s Let's Encrypt** — automaticky vydáva a obnovuje certifikáty SSL pre všetky domény. Kľúčové funkcie, vďaka ktorým je Coolify funkčne porovnateľné s Vercel: | Funkcia | Vercel | Coolify | |----|----|----| | Automatické nasadenie pri pushnutí do git | ✅ | ✅ (cez webhook GitHubu) | | Bezplatné HTTPS | ✅ | ✅ (Let's Encrypt) | | Náhľadové nasadenia PR | ✅ | ✅ (cez GitHub App) | | Používateľské rozhranie premenných prostredia | ✅ | ✅ | | Zálohy databáz | ❌ (nemá vlastné databázy) | ✅ (do úložiska kompatibilného so S3) | | PostgreSQL / Redis / MongoDB | \$20+/mesiac za každú | ✅ Jedným kliknutím, zadarmo | | Naplánované úlohy (cron) | ❌ | ✅ (syntax cron) | | Poplatok za používateľské miesto | \$20/miesto/mesiac | Žiadny | | Závislosť od dodávateľa | Vysoká (Edge Functions, ISR) | Žiadna (váš Docker) | | Globálna CDN | ✅ | ❌ (iba váš VPS) | Jediná vec, ktorú Coolify štandardne neponúka, je globálna CDN. Toto je úprimná odpoveď. Ak má váš projekt globálne publikum a potrebujete znížiť latenciu pre používateľov v USA a Európe, použite Cloudflare; pre statický obsah je zadarmo. Cena: **verzia s vlastným hostingom je navždy bezplatná**, bez limitov počtu aplikácií, serverov ani nasadení. Coolify Cloud je dostupný za \$5/mesiac pre 2 servery + \$3 za každý ďalší — samotné servery však stále patria vám; Coolify Cloud iba hostuje informačný panel. Najnovšie vydanie je **v4.1.0 z 18. mája 2026**. Medzi nové funkcie patrí build pack Railpack v beta verzii, auditné záznamy, rozdiely konfigurácie medzi nasadeniami a natívny koncový bod MCP (iba na čítanie). Zdroj: [vydania na GitHube](https://github.com/coollabsio/coolify/releases). ## Aký VPS si vybrať pre Coolify v roku 2026?
Hlavný bod Coolify vyžaduje minimálne 2 vCPU, 2 GB RAM, 30 GB SSD a Ubuntu LTS (20.04, 22.04 alebo 24.04). Takýto VPS pohodlne zvládne súčasne 3–5 projektov vytvorených vibe codingom.
Minimálne požiadavky Coolify pochádzajú priamo z [oficiálnej dokumentácie](https://coolify.io/docs/get-started/installation): | Parameter | Minimum | Odporúčané | |-------------|----------------------------------|---------------------------| | CPU | 2 jadrá | 2–4 jadrá | | RAM | 2 GB | 4 GB (s rezervou na buildy) | | Úložisko | 30 GB | 50–80 GB (na obrazy + databázy) | | Architektúra | AMD64 alebo ARM64 (64-bit) | AMD64 | | OS | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS | | Root | Povinný | Cez kľúč SSH, nie heslo | Minimum — 2 GB RAM — je **pevná dolná hranica**. Pri 1 GB sa inštalátor dostane po Docker, narazí na OOM (nedostatok pamäte) a zasekne sa. Na RAM nešetrite. Zdroje cien: [Timeweb Cloud](https://timeweb.cloud/services/vds-vps), [FirstVDS](https://firstvds.ru/products/vds_vps_hosting) a [Selectel](https://selectel.ru/services/cloud/vps-vds). Ak potrebujete viac výkonu (databázu s veľkosťou 100 GB, niekoľko inštancií Postgres), vyberte Aeza Dedicated. Čomu sa vyhnúť: - **Zdieľaný VPS s 512 MB–1 GB RAM** — nestačí ani na Coolify. Je určený pre statické weby na nginx, nie pre PaaS. Chcete nielen nastaviť nasadzovanie, ale aj vytvoriť **nastavenie, vďaka ktorému bude Claude spoľahlivé**? Coolify je nástroj na vykonávanie, ale bez štruktúrovaného kontextu ([`CLAUDE.md`](https://ailoot.ai/blog/sk/claude-md-template/), [druhého mozgu](https://ailoot.ai/blog/sk/claude-code-second-brain/) a [kontextového inžinierstva](https://ailoot.ai/blog/sk/context-engineering/)) bude Claude pri dlhých úlohách stále halucinovať. Kompletné nastavenie zahŕňa všetky tri prvky: **klon AI + Druhý mozog + Kontextové inžinierstvo** — táto kombinácia mení Claude z „asistenta, ktorý halucinuje“ na spoľahlivý nástroj. ## Ako nainštalovať Coolify za 5 minút
Hlavný bod Inštalácia pozostáva z jediného príkazu curl z dokumentácie. Po spustení sa na porte 8000 zobrazí webové rozhranie. Tam vytvoríte prvého používateľa s právami správcu a uvidíte prázdny informačný panel. Skutočný čas od čistej inštalácie Ubuntu po spustenie Coolify je 5–7 minút, z toho 3–4 minúty zaberie `apt-get install docker`. Skript stiahne potrebné závislosti a nakonfiguruje Docker; stačí počkať, kým sa dokončí.
**Krok 1. Pripojte sa k VPS cez SSH.** Po vytvorení VPS u poskytovateľa sa IP adresa servera a heslo root zobrazia v e-maile alebo na ovládacom paneli. Pripojte sa z lokálneho počítača: ```bash ssh root@1.2.3.4 ``` Ak vám poskytovateľ namiesto hesla dal kľúč SSH, pripojte sa pomocou `-i path/to/key`. Ďalej predpokladám, že používate čistú inštaláciu Ubuntu 22.04 alebo 24.04 LTS. **Krok 2. Spustite príkaz na inštaláciu Coolify.** Jeden príkaz z [oficiálnej dokumentácie](https://coolify.io/docs/get-started/installation): ```bash curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash ``` Skript vykoná tri úlohy: 1. Skontroluje systém (Ubuntu LTS? root? AMD64?) 2. Nainštaluje Docker a Docker Compose, ak ešte nie sú nainštalované 3. Stiahne obrazy Coolify (`coolify/coolify`, `coolify/realtime`, `traefik`) a spustí ich na pozadí cez docker-compose Trvá to 3–5 minút. Uvidíte prebiehajúce záznamy `apt-get` a potom `docker pull`. Keď sa zobrazí `Coolify v4.1.0 is now running`, prejdite na krok 3. **Krok 3. Otvorte webové rozhranie.** Otvorte to v prehliadači: ``` http://1.2.3.4:8000 ``` Coolify zobrazí sprievodcu nastavením — formulár na vytvorenie prvého používateľa. Zadajte e-mail a heslo a uložte ich. Tento používateľ sa automaticky stane správcom; zatiaľ nepotrebujete žiadnych ďalších používateľov. Po uložení sa dostanete na prázdny informačný panel: vľavo je bočný panel s položkami Resources / Projects / Servers / Sources / Notifications / Settings a uprostred výzva „Add your first resource“. **Krok 4. Otvorte porty vo firewalle poskytovateľa (nie v UFW).** Coolify už beží, ale zvonka je prístupný iba port 8000 (informačný panel). Aby sa používatelia dostali k vašim aplikáciám, musíte otvoriť porty 80 (HTTP) a 443 (HTTPS): | Port | Účel | |----|----| | 22 | Prístup k serveru cez SSH | | 80 | Prijíma prevádzku HTTP; potrebný na overenie Let's Encrypt | | 443 | Prijíma prevádzku HTTPS používateľov | | 8000 | Informačný panel Coolify (zatvoríme ho po nastavení vlastnej domény pre informačný panel) | Dôležitý háčik z oficiálnej dokumentácie:

Docker používa pravidlá iptables založené na NAT, ktoré môžu obísť tradičné linuxové firewally, ako je UFW.

— Dokumentácia Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall
To znamená, že aj keď povolíte UFW a zatvoríte všetky porty, Docker bude naďalej sprístupňovať svoje kontajnery cez iptables. UFW je tu zbytočné. Riešením je **otvárať a zatvárať porty na ovládacom paneli poskytovateľa**, nie cez UFW. V službách Timeweb / Selectel / Aeza to nastavíte v časti „Network → Firewall“ webovej konzoly. **Krok 5 (voliteľný). Priraďte informačný panel k svojej doméne.** Ak chcete navštevovať `https://coolify.example.com` namiesto `http://1.2.3.4:8000`, vytvorte záznam DNS A `coolify.example.com → 1.2.3.4`, v Coolify prejdite na **Settings → Instance Settings → Instance Domain**, zadajte subdoménu a uložte. Coolify si vyžiada certifikát Let's Encrypt a o minútu znovu načíta informačný panel cez HTTPS. Potom môžete vo firewalle zatvoriť port 8000 — informačný panel bude dostupný cez HTTPS na štandardnom porte 443. ## Ako pripojiť GitHub: App alebo PAT?
Hlavný bod Coolify podporuje dva spôsoby pripojenia GitHubu: **GitHub App** (odporúčaný) a **Personal Access Token (PAT)**. Použite GitHub App: nastavenie sprievodcom trvá 5 minút, náhľady PR fungujú a povolenia možno presne obmedziť na úroveň repozitára. PAT je zastaraná možnosť pre staršie prípady; nemá náhľadové nasadenia a hrozí pri ňom globálny prístup ku všetkým vašim repozitárom. Oficiálna dokumentácia to hovorí priamo: „pre 95% používateľov je GitHub App správnou voľbou“.
V Coolify prejdite na **Sources → + Add → GitHub App**. Coolify zobrazí sprievodcu s tromi obrazovkami: 1. **Názov a opis** — pomenujte zdroj (zadajte `github-main`) a prípadne pridajte opis. 2. **Konfigurácia na GitHube** — tlačidlo, ktoré vás presmeruje na GitHub.com a automaticky otvorí formulár na vytvorenie GitHub App so správnymi povoleniami. 3. **Potvrdenie** — po návrate z GitHubu kliknite na „Save“. V druhom kroku vás GitHub požiada o potvrdenie povolení, ktoré Coolify vyžaduje: | Povolenie | Úroveň | Účel | |-----------------|------------|----------------------------------------------| | Contents | Iba na čítanie | Klonovanie repozitára | | Pull Requests | Čítanie a zápis | Vytváranie náhľadových nasadení a komentovanie PR | | Email addresses | Iba na čítanie | Identifikácia commitov | | Metadata | Iba na čítanie | Zobrazenie repozitárov | Ide o **minimálne povolenia** — GitHub App nevidí vaše súkromné kľúče, nemôže zapisovať do `main` a nemá prístup k repozitárom, ktoré ste výslovne nepripojili. Z oficiálnej dokumentácie: Personal Access Token (PAT) je stará metóda; **neodporúčam ho používať**. Nevýhody: - PAT poskytuje globálny prístup ku všetkým vašim repozitárom (vrátane súkromných) - Náhľady PR nefungujú — táto funkcia je dostupná iba cez GitHub App - Token má dlhú platnosť (90 dní, rok alebo neobmedzene) — ak unikne, je to problém PAT použite iba vtedy, ak pracujete s repozitárom organizácie, ktorej bezpečnostná politika zakazuje GitHub Apps a neexistuje spôsob, ako to obísť. Po uložení zdroja v Coolify sa na informačnom paneli zobrazí GitHub App so zoznamom pripojených repozitárov. Pri vytvorení novej aplikácie si jedným kliknutím budete môcť vybrať ktorýkoľvek z nich. ## Ako nasadiť projekt Next.js z Claude Code v 6 krokoch
Hlavný bod Celý postup od prázdneho nastavenia Claude Code po živý web: 1) spustite `claude` v prázdnom priečinku, opíšte projekt a Claude vygeneruje kód; 2) spustite `git init && git remote add` (Claude to môže vykonať samo pomocou príkazu slash); 3) odošlite zmeny do GitHubu; 4) v Coolify vyberte „+ New Resource → Application“ a zvoľte repozitár; 5) pridajte premenné prostredia; 6) kliknite na Deploy. Coolify rozpozná, že ide o Next.js, zvolí build pack Nixpacks, vytvorí obraz Docker za 3–5 minút a poskytne dočasnú doménu s HTTPS pripraveným na použitie.
**Krok 1. Opíšte projekt Claude Code v prázdnom priečinku.** ```bash mkdir my-vibe-app cd my-vibe-app git init claude ``` V relácii: ``` Vytvor projekt aplikácie Next.js 14 s app routerom: - domovská stránka so zoznamom používateľov - koncový bod /api/users vracia pole z databázy - Postgres cez Prisma - Tailwind na štýly - .env.example s DATABASE_URL - README.md s pokynmi na spustenie projektu ``` Claude vygeneruje štruktúru súborov, package.json, prisma/schema.prisma a .env.example. Požiadajte ho tiež: ``` Vytvor Dockerfile na produkčné buildy a súbor .dockerignore. ``` Nie je to povinné — Coolify vytvorí build pomocou Nixpacks aj bez Dockerfile. Dockerfile vám však dáva kontrolu nad procesom a pri väčších projektoch je rýchlejší. **Krok 2. Vytvorte repozitár GitHub a odošlite doň zmeny.** Môžete to urobiť ručne cez používateľské rozhranie GitHubu + `git remote add origin ...`, ale Claude Code to zvládne samo: ``` /commit-push-pr Initial Next.js app generated with Claude Code ``` Alebo jednoducho povedzte: „Commitni všetko a odošli to do nového repozitára `my-vibe-app` v mojom účte.“ Claude použije CLI `gh` na vytvorenie súkromného (alebo verejného) repozitára a prvý push. Zdroj: [oficiálny príkaz Claude Code](https://github.com/anthropics/claude-code/blob/main/.claude/commands/commit-push-pr.md). **Krok 3. Vytvorte aplikáciu v Coolify.** Na informačnom paneli Coolify kliknite na **+ New → Application**. Otvorí sa formulár: 1. **Zdroj** — vyberte `github-main` (GitHub App, ktoré ste pripojili v predchádzajúcej H2) 2. **Repozitár** — zo zoznamu vyberte `my-vibe-app` 3. **Branch** — `main` 4. **Build Pack** — Coolify ho rozpozná automaticky. Ak existuje Dockerfile, použije `dockerfile`. Inak použije `nixpacks`. Možno to zmeniť ručne. 5. **Doména** — zatiaľ ponechajte navrhnutú hodnotu; je dočasná a neskôr ju nahradíte vlastnou 6. **Port** — predvolene `3000` pre Next.js Uložte. **Krok 4. Pridajte premenné prostredia.** Vytvorenú aplikáciu otvorte na karte **Environment Variables**. Premenné pridávajte po jednej: ``` DATABASE_URL=postgresql://user:pass@db-host:5432/mydb NODE_ENV=production ANTHROPIC_API_KEY=sk-ant-... ``` Ak nemáte databázu, vytvorte ju priamo v Coolify: **+ New → Database → PostgreSQL**. Coolify spustí kontajner Postgres za 30 sekúnd a poskytne interné DATABASE_URL v tvare `postgresql://postgres:pass@postgres-xyz:5432/postgres` — vložte ho do aplikácie. Všetky premenné sú v databáze Coolify šifrované a nezobrazujú sa v build logoch. **Krok 5. Kliknite na Deploy.** V pravom hornom rohu je modré tlačidlo Deploy. Na karte Logs sa zobrazia živé záznamy: ``` [stage: clone] Cloning '' [stage: build] Detected Next.js, using Nixpacks [stage: build] Installing Node 20, npm 10 [stage: build] npm install (245s) [stage: build] npm run build (87s) [stage: deploy] Creating container my-vibe-app-xyz [stage: deploy] Container started, health check passed [stage: proxy] Traefik routing configured for xxx.example-domain.test [stage: ssl] Let's Encrypt cert issued for xxx.example-domain.test ``` Prvý build trvá 3–5 minút (stiahne základný obraz Node a nainštaluje závislosti). Ďalšie buildy trvajú 60–90 sekúnd vďaka ukladaniu vrstiev Docker do vyrovnávacej pamäte. Keď sa stav zmení na **Running**, skopírujte URL aplikácie z poľa **Domains** v Coolify a otvorte presne túto adresu. Ďalej ju označujeme ako ``; označenie v hranatých zátvorkách je zástupný údaj, nie skutočná adresa. Mala by sa zobraziť domovská stránka s HTTPS pripraveným na použitie. Ide o bezplatnú službu wildcard DNS, ktorá prekladá ľubovoľnú subdoménu obsahujúcu IP adresu (`1-2-3-4.example-domain.test` → `1.2.3.4`). Coolify ju používa pre dočasné domény, aby ste mohli web otvoriť hneď bez konfigurácie vlastného DNS. **Krok 6. Skontrolujte, či všetko funguje.** Otvorte URL aplikácie z predchádzajúceho kroku s pridanou cestou `/api/users`, napríklad `/api/users`, bez zdvojenia lomky. Ide o koncový bod JSON vytvorený v kroku 1; koreňová URL aplikácie je domovská stránka. Ak sa zobrazí chyba 500, stack trace nájdete na karte Logs. Najčastejším problémom pri prvom nasadení je, že DATABASE_URL odkazuje na neexistujúcu databázu. Opravte to vytvorením inštancie PostgreSQL v Coolify (pozrite krok 4 vyššie) a nahradením DATABASE_URL. 15 minút od chvíle, keď si objednáte VPS. V pôvodnom príklade tento postup na čistom serveri trval 12–18 minút. ## Ako nastaviť vlastnú doménu a HTTPS
Hlavný bod Vlastnú doménu pripojíte v 3 krokoch: vytvorte záznam DNS A smerujúci na IP servera, v nastaveniach Coolify zadajte doménu namiesto dočasnej domény, zapnite Automatic HTTPS a kliknite na Redeploy. Let's Encrypt automaticky vydá certifikát SSL 2–3 minúty po propagácii DNS (zvyčajne 5–30 minút). Kľúčovou požiadavkou je, aby sa DNS už prekladalo v čase, keď kliknete na Redeploy; inak overenie Let's Encrypt zlyhá a na ďalší pokus budete musieť počkať 12 minút.
**Krok 1. Vytvorte záznam DNS A na ovládacom paneli registrátora.** Pôvodné príklady používajú domény hostované u Reg.ru, Beget alebo Timeweb. Postup je rovnaký: | Typ záznamu | Názov | Hodnota | |------------|---------------------------|------------------------| | A | `app` (alebo `@` pre koreňovú doménu) | `1.2.3.4` (IP servera) | Uložte ho, otvorte konzolu a skontrolujte: ```bash dig app.example.com +short # Mal by vrátiť 1.2.3.4 ``` Ak nevráti nič alebo inú IP, DNS sa ešte nepropagovalo. Počkajte 5–30 minút. **Krok 2. Zadajte svoju doménu v Coolify.** V aplikácii otvorte kartu **Configuration → General**. V poli **Domains** nahraďte dočasnú URL aplikácie skopírovanú z Coolify adresou `https://app.example.com` (s vlastnou nakonfigurovanou doménou). Zapnite **Automatic HTTPS** (zvyčajne je predvolene zapnuté). Uložte a kliknite na **Redeploy**. **Krok 3. Počkajte na certifikát Let's Encrypt.** Build logy zobrazia: ``` [stage: ssl] Requesting Let's Encrypt cert for app.example.com [stage: ssl] HTTP challenge sent to /.well-known/acme-challenge/xxx [stage: ssl] Validation passed, cert issued [stage: ssl] Cert installed, HTTPS enabled ``` O 2–3 minúty bude váš web dostupný na adrese `https://app.example.com` so zeleným zámkom v paneli s adresou. Čo sa môže pokaziť pri Let's Encrypt (3 hlavné problémy z [oficiálnej príručky na riešenie problémov](https://coolify.io/docs/troubleshoot/dns-and-domains/lets-encrypt-not-working)): 1. **Port 80 je vo firewalle zatvorený.** Let's Encrypt overuje pomocou HTTP challenge — odošle požiadavku na `http://app.example.com/.well-known/acme-challenge/xxx`. Bez portu 80 overenie neprejde. Otvorte ho vo firewalle poskytovateľa. 2. **Je zapnutý proxy server Cloudflare (oranžový obláčik).** Zachytí požiadavku Let's Encrypt a vráti vlastnú zástupnú stránku — overenie zlyhá. Riešením je prepnúť na „DNS only“ (sivý obláčik) alebo nastaviť challenge DNS-01 cez API Cloudflare. 3. **DNS sa ešte nepropagovalo.** Ak ste pred 30 sekundami vytvorili záznam A a hneď klikli na Redeploy, Let's Encrypt vašu doménu neuvidí. Počkajte 5–30 minút, kým sa DNS rozšíri medzi servery. Limit požiadaviek Let's Encrypt: **5 neúspešných pokusov za hodinu pre jednu doménu**, pričom limit sa obnovuje tempom 1 pokus každých 12 minút. Ak limit dosiahnete, neklikajte na Redeploy 10-krát za sebou; skontrolujte logy, opravte problém a skúste to znova o 12 minút. ## Ako Claude Code spravuje Coolify cez MCP?
Hlavný bod Prostredníctvom Model Context Protocol získava Claude Code priamy prístup k API Coolify — môžete povedať „nasadiť túto aplikáciu“ a spustiť build, skontrolovať stav, čítať logy alebo aktualizovať premenné prostredia. Existujú tri možnosti: forsonny/Coolify-MCP-Server (základná, 7 kategórií operácií), dazeb/coolify-mcp-enhanced (15+ ďalších nástrojov s nasadením databázy jedným kliknutím) a ajmcclary/Coolify-Manager (Claude Skill vytvorený okolo oficiálneho CLI). Od v4.1.0 (18. mája 2026) Coolify poskytuje natívny koncový bod MCP bez serverov tretích strán — zatiaľ je však iba na čítanie.
Model Context Protocol (MCP) je štandard od Anthropic, ktorý Claude Code umožňuje komunikovať s externými systémami (viac informácií nájdete v [sprievodcovi servermi MCP](https://ailoot.ai/blog/sk/mcp-servers-claude-code/)). Pripojte server MCP a Claude získa súbor nástrojov, ktoré môže volať. Pre Coolify existujú tri hotové servery a jedna natívna možnosť. **Možnosť 1. forsonny/Coolify-MCP-Server-for-Claude-Code — základná.** Čo dokáže: - **Aplikácie:** vytvárať, spúšťať, zastavovať, reštartovať - **Služby:** zobrazovať, vytvárať, spúšťať/zastavovať/reštartovať - **Nasadenia:** zobraziť spustené, načítať podľa UUID - **Tímy a členovia:** zobraziť, získať informácie - **Kľúče SSH:** zobraziť, vytvárať - **Premenné prostredia:** úplné CRUD pre aplikácie a služby - **Informácie o serveri:** domény na server, stav, verzia Inštalácia: ```bash git clone '' cd Coolify-MCP-Server-for-Claude-Code npm install npm run build # In .env: # COOLIFY_BASE_URL=https://coolify.example.com # COOLIFY_API_TOKEN=[from Coolify Settings → API Tokens] npm run setup # automatically configures Claude Code ``` Potom môžete v Claude Code zadať: ``` Zobraz stav aplikácie my-vibe-app v Coolify a jej 3 najnovšie nasadenia. ``` Claude vráti tabuľku. **Možnosť 2. dazeb/coolify-mcp-enhanced — rozšírená (odporúčaná).** Čo pridáva k základnej súprave: - **Nasadenie PostgreSQL / Redis / MinIO jedným kliknutím** cez AI — požiadajte „nastav mi Postgres“ a vytvorí kontajner a vráti DATABASE_URL - **Monitorovanie v reálnom čase + využitie zdrojov** — CPU/RAM pre každú aplikáciu v reálnom čase - **Hromadné aktualizácie konfigurácie env** — aktualizácia 20 premenných jediným príkazom - **Podpora Docker Compose** — nasadenie aplikácií s viacerými službami Konfigurácia pre Claude Code (`.mcp.json` v koreňovom priečinku projektu): ```json { "mcpServers": { "coolify-enhanced": { "command": "node", "args": ["/path/to/coolify-mcp-enhanced/dist/index.js"], "env": { "COOLIFY_ACCESS_TOKEN": "your-token-here", "COOLIFY_BASE_URL": "https://coolify.example.com" } } } } ``` **Možnosť 3. ajmcclary/Coolify-Manager — Claude Skill založený na CLI.** Nie je to server MCP, ale Claude Code Skill, ktorý obaluje oficiálne Coolify CLI. Obsahuje: - Diagnostiku stavu služieb a kontajnerov - Diagnostiku certifikátov SSL - Podporu viacerých inštancií (ak máte niekoľko serverov Coolify) - Postupy riešenia problémov Inštalácia: stiahnite skill a umiestnite ho do `~/.claude/skills/coolify-manager/`. Claude Code ho rozpozná a ponúkne pri relevantných úlohách. **Možnosť 4 (novinka z mája 2026). Natívne MCP v Coolify v4.1.0.** Zoznam zmien v4.1.0 z 18. mája 2026 uvádza: > Pridaná podpora MCP na úrovni inštancie s nástrojmi iba na čítanie pre zdroje Coolify a API/rozhranie. Coolify teraz poskytuje vlastný koncový bod MCP — Claude Code môžete pripojiť priamo bez serverov tretích strán. Zatiaľ je **iba na čítanie** (zoznamy aplikácií, stavy, konfigurácie), bez operácií na úpravu. Na väčšinu úloh, ako napríklad „povedz mi o infraštruktúre“, to však stačí. Pripojte ho cez `.mcp.json`: ```json { "mcpServers": { "coolify-native": { "url": "https://coolify.example.com/api/v1/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Počkajte na úplný prístup na zápis v natívnom MCP vo v4.2 alebo v4.3 — tím Coolify ho prisľúbil do konca roka 2026. ## 5 úskalí pri prvom nasadení — a ako sa im vyhnúť
Hlavný bod Najčastejšími chybami pri prvom nasadení sú nedostatok RAM, zatvorený port 80, proxy Cloudflare narúšajúci Let's Encrypt, UFW, ktorý nedokáže ochrániť Docker, a výber PAT namiesto GitHub App. Všetko je uvedené v oficiálnej dokumentácii, ale bez praktických skúseností na tieto problémy ľahko narazíte. Nižšie je kontrolný zoznam s 5 bodmi založený na pôvodnej skúsenosti s prvou inštaláciou Coolify.
**Úskalie 1: Menej než 2 GB RAM — inštalácia zlyhá s OOM.** Príznak: `curl install.sh` sa dostane po `docker pull coolify/coolify`, zasekne sa na 70 % a potom sa proces ukončí s `Killed (signal 9)`. Záznamy `dmesg | tail` zobrazia `Out of memory: Killed process`. Riešenie: ```bash # Vytvorte súbor swap s veľkosťou 4 GB na dočasné vyriešenie problému sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab ``` Z dlhodobého hľadiska prejdite na 4 GB RAM. Coolify funguje so swapom, ale buildy veľkých projektov Next.js môžu zlyhať. **Úskalie 2: UFW je zapnuté, ale Docker stále otvára porty.** Príznak: zapli ste UFW a zatvorili všetky porty okrem 22, ale vaša aplikácia je stále dostupná z internetu na nejakom náhodnom porte (napríklad 3000). Dôvod podľa [oficiálnej dokumentácie](https://coolify.io/docs/knowledge-base/server/firewall):

Coolify beží v Dockeri, ktorý používa pravidlá iptables založené na NAT a môže obísť tradičné linuxové firewally, ako je UFW.

— Dokumentácia Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall
Riešenie: použite **firewall na ovládacom paneli poskytovateľa**, nie UFW. Timeweb / Selectel / Aeza majú sekciu „Firewall“ alebo „Network → Firewall“, kde môžete nastaviť pravidlá na úrovni virtuálnej siete — platia ešte predtým, ako pakety dorazia k Dockeru. Alternatívou je ufw-docker, skript, ktorý upravuje UFW kvôli kompatibilite s Dockerom. Je to však zložitejšie než kliknutie na ovládacom paneli. **Úskalie 3: Proxy Cloudflare (oranžový obláčik) narúša Let's Encrypt.** Príznak: po kliknutí na Redeploy sa v logoch zobrazí `Let's Encrypt validation failed - challenge returned 403`. Dôvod: Cloudflare sprostredkúva požiadavku HTTP od Let's Encrypt a namiesto súboru challenge vracia vlastnú stránku. Riešenie — vyberte jednu z dvoch možností: 1. **Prepnite na „DNS only“** (sivý obláčik v Cloudflare). Nevýhoda: prídete o CDN a ochranu Cloudflare. 2. **Nastavte challenge DNS-01 cez API Cloudflare.** V Coolify prejdite na Settings → SSL Configuration, vyberte poskytovateľa Cloudflare a zadajte token API s povoleniami Zone:Read a DNS:Edit. Let's Encrypt overí doménu pomocou záznamu TXT namiesto HTTP. Druhá možnosť sa nastavuje zložitejšie, ale zachováva proxy Cloudflare. **Úskalie 4: PAT namiesto GitHub App — náhľady PR nefungujú.** Príznak: pripojili ste GitHub pomocou Personal Access Token; všetko funguje, ale pre PR sa nevytvárajú náhľadové nasadenia. Otvorili ste PR na GitHube, ale v Coolify sa nič nezobrazilo. Dôvod: náhľady PR sú výhradnou funkciou GitHub App. PAT nedostáva udalosti `pull_request` cez webhook. Riešenie: znova pripojte GitHub cez App. Sources → Add → GitHub App → dokončite sprievodcu. Starý zdroj PAT môžete odstrániť. **Úskalie 5: Tvrdenie „Coolify == Vercel“ nie je celkom pravdivé.** Čo Coolify štandardne **nedokáže**: | Vercel | Coolify | Čo robiť | |----|----|----| | Globálna CDN | Nie | Použite Cloudflare (zadarmo pre statický obsah) | | Incremental Static Regeneration | Nie | `revalidatePath` funguje iba na vašom serveri | | Optimalizácia obrázkov | Nie | Použite `next/image` s lokálnym loaderom alebo Cloudflare Images | | Automatické škálovanie pri špičkách | Nie | Škálujte ručne; upgradujte VPS | | Edge Functions | Nie | Použite bežné API routes | Ak je váš projekt SaaS s vysokou návštevnosťou, globálnym publikom a požiadavkami na latenciu \< 100 ms na celom svete, Coolify sa nehodí; vyberte Vercel Enterprise. Ak ste vibe coder s MVP, ktoré testujete na 100–1,000 používateľoch denne, Coolify pokryje všetko. Z úprimnej analýzy vlastného hostingu: Pätnásť minút v názve tohto návodu sa vzťahuje na hladký priebeh prvého nasadenia jedného projektu. Kompletné nastavenie infraštruktúry s monitorovaním, zálohami a upozorneniami zaberie jeden či dva večery. Buďte k sebe úprimní. ## Koľko ušetríte za rok v porovnaní s Vercel?
Hlavný bod Pri rovnakej záťaži môže byť plne spravovaná možnosť s vysokou dostupnosťou za $89.99/mesiac lacnejšia než účet Vercel vo výške $601.30. Treba počítať aj so „skrytou časovou daňou“: 5–10 hodín na úvodné nastavenie a 1–2 hodiny mesačne na údržbu.
Nasledujúce sumy Vercel sú odhady scenárov z mája 2026, nie aktuálne ponuky. Predstavujú iba jednu stranu porovnania. Coolify s vlastným hostingom nemá licenčný poplatok, no VPS, zálohy, úložisko, prenos dát a prevádzka stále stoja peniaze. Získajte ponuku spĺňajúcu vyššie uvedené požiadavky; scenáre neuvádzajú číselnú cenu VPS, preto by pevná úspora nebola podložená. Nech **C** označuje celkový mesačný účet za VPS, záložné úložisko, dodatočný prenos dát, monitorovanie a prípadný platený panel. Každý výdavok započítajte iba raz. Nech **r** je vaša hodinová cena prevádzkovej práce v rovnakej mene. Odhad článku je 5–10 hodín úvodne a 1–2 hodiny mesačne: **17–34 hodín v prvom roku** a **12–24 hodín v ďalších rokoch**. | Scenár | Odhad Vercel/mesiac | Vercel/rok | Infraštruktúra Coolify/mesiac | TCO Coolify v prvom roku vrátane práce | Úspora oproti Vercel v prvom roku | |----|----|----|----|----|----| | Jeden prototyp, 100,000 návštev/mesiac | $20 základ + ~$5 prenos = $25 | $300 | C | 12C + (17–34)r | $300 − 12C − (17–34)r | | Päť projektov na jednom VPS | $20 základ + $30 prenos/funkcie = $50 | $600 | C | 12C + (17–34)r | $600 − 12C − (17–34)r | | Traja vývojári, päť projektov | $60 miesta + $30 prenos = $90 | $1,080 | C | 12C + (17–34)r | $1,080 − 12C − (17–34)r | Ak záťaže potrebujú iné veľkosti servera, použite pre každý scenár samostatné C. Pri mesačnom porovnaní rozložte počiatočné nastavenie na 12 mesiacov: ekvivalent prvého roka je **C + (17–34)r/12**. TCO ďalších rokov je **12C + (12–24)r**. Vzorce porovnávajú uvedený odhad Vercel s vlastným hostingom; porovnateľné prevádzkové náklady započítajte aj pri Vercel. Záporná úspora znamená pri vašich vstupoch drahší vlastný hosting. Ak r už obsahuje mzdu technika, nezapočítajte ju celú znova. Pred prechodom vyplňte C zo skutočnej ponuky poskytovateľa a plánu záloh, určte r a potom mesiac porovnávajte skutočné používanie. Bez týchto vstupov článok poskytuje cenový model, nie dolárovú úsporu. Hlavným prínosom nie sú peniaze. Prechodom na Coolify **zmizne kategória „závislý od platobnej politiky niekoho iného“**. Virtuálne sprostredkovateľské karty s 20 % províziou už nepotrebujete. Coolify nie je lacnejší Vercel. Je to iná kategória produktu: infraštruktúra patrí vám, nesiete za ňu zodpovednosť a šetríte peniaze tým, že prijímate jej zložitosť. Ak je nasadenie prototypu vašou prvou úlohou po jeho vytvorení v Claude Code, správa prostredia (env, tajomstvá, naplánované úlohy, zálohy) je súčasťou [**kontextového inžinierstva**](https://ailoot.ai/blog/sk/context-engineering/). Bez štruktúry, ktorá určuje „kde sa čo nachádza“, sa Claude stratí a pri každej zmene strácate čas. Kompletné nastavenie zahŕňa: **klon AI** ([Skills](https://ailoot.ai/blog/sk/claude-code-skills-library/) a [Subagents](https://ailoot.ai/blog/sk/claude-code-subagents/) prispôsobené vašej metodike) + [**Druhý mozog**](https://ailoot.ai/blog/sk/claude-code-second-brain/) (znalostnú bázu projektu) + **Kontextové inžinierstvo** ([Plan Mode](https://ailoot.ai/blog/sk/claude-code-plan-mode/), `/compact`, prostredie vykonávania). Toto sú **3 piliere**, bez ktorých AI halucinuje.
### Zdroje - [Oficiálna dokumentácia Coolify: Úvod](https://coolify.io/docs/get-started/introduction) - [Návod na inštaláciu Coolify](https://coolify.io/docs/get-started/installation) - [Prehľad build packov Coolify](https://coolify.io/docs/applications/build-packs/overview) - [Znalostná báza Coolify: Firewall](https://coolify.io/docs/knowledge-base/server/firewall) - [Riešenie problémov Let's Encrypt v Coolify](https://coolify.io/docs/troubleshoot/dns-and-domains/lets-encrypt-not-working) - [Cenník Coolify](https://coolify.io/pricing) - [GitHub Coolify: vydania v4.1.0](https://github.com/coollabsio/coolify/releases) - [Prehľad Claude Code](https://code.claude.com/docs/en/overview) - [VPS Timeweb Cloud](https://timeweb.cloud/services/vds-vps) - [VPS FirstVDS](https://firstvds.ru/products/vds_vps_hosting) - [VPS/VDS Selectel](https://selectel.ru/services/cloud/vps-vds/) - [Cenník Vercel](https://vercel.com/pricing)
Kompletný pracovný postup pre kontext: **klon AI + Druhý mozog + Kontextové inžinierstvo**. Ďalšie materiály nájdete na [Ailoot](https://ailoot.ai/). ## Otázky a odpovede: Coolify a Claude Code: Nasadenie projektu na vlastný VPS ### Ktorá URL má po nasadení vrátiť JSON? Skopírujte URL aplikácie z poľa Domains v Coolify a otvorte jej cestu /api/users. Koreňová URL je domovská stránka; /api/users je koncový bod JSON určený v ukážkovom projekte. ### Ako vypočítať úsporu vlastného hostingu? Do C sčítajte mesačný VPS, zálohy, úložisko, prenos, monitorovanie a voliteľné poplatky panelu. TCO prvého roka je 12C plus 17–34 hodín pri vašej hodinovej cene; porovnajte ho s ročným odhadom Vercel scenára a na oboch stranách zahrňte porovnateľnú prevádzku. ## Ailoot · Spoločnosť a jej portfólio projektov Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI. Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách. Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.