Blog

Coolify a Claude Code: Nasadenie projektu na vlastný VPS

Markdown

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.

Prečítať celý článok

Dokumentácia Ailoot — 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:

FunkciaVercelCoolify
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ľaVysoká (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.

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:

ParameterMinimumOdporúčané
CPU2 jadrá2–4 jadrá
RAM2 GB4 GB (s rezervou na buildy)
Úložisko30 GB50–80 GB (na obrazy + databázy)
ArchitektúraAMD64 alebo ARM64 (64-bit)AMD64
OSUbuntu LTS 20.04 / 22.04 / 24.0422.04 LTS
RootPovinný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, FirstVDS a Selectel.

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, druhého mozgu a kontextového inžinierstva) 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:

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:

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
22Prístup k serveru cez SSH
80Prijíma prevádzku HTTP; potrebný na overenie Let's Encrypt
443Prijíma prevádzku HTTPS používateľov
8000Informač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
ContentsIba na čítanieKlonovanie repozitára
Pull RequestsČítanie a zápisVytváranie náhľadových nasadení a komentovanie PR
Email addressesIba na čítanieIdentifikácia commitov
MetadataIba na čítanieZobrazenie 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.

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.

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 '<repository-url-from-github>'
[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 <app-url-from-coolify>; 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 <app-url-from-coolify>/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áznamuNázovHodnota
Aapp (alebo @ pre koreňovú doménu)1.2.3.4 (IP servera)

Uložte ho, otvorte konzolu a skontrolujte:

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):

  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). 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:

git clone '<OFFICIAL_URL>'
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):

{
  "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:

{
  "mcpServers": {
    "coolify-native": {
      "url": "https://coolify.example.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

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:

# 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:

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:

VercelCoolifyČo robiť
Globálna CDNNiePoužite Cloudflare (zadarmo pre statický obsah)
Incremental Static RegenerationNierevalidatePath funguje iba na vašom serveri
Optimalizácia obrázkovNiePoužite next/image s lokálnym loaderom alebo Cloudflare Images
Automatické škálovanie pri špičkáchNieŠkálujte ručne; upgradujte VPS
Edge FunctionsNiePouž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árOdhad Vercel/mesiacVercel/rokInfraštruktúra Coolify/mesiacTCO 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$300C12C + (17–34)r$300 − 12C − (17–34)r
Päť projektov na jednom VPS$20 základ + $30 prenos/funkcie = $50$600C12C + (17–34)r$600 − 12C − (17–34)r
Traja vývojári, päť projektov$60 miesta + $30 prenos = $90$1,080C12C + (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. 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 a Subagents prispôsobené vašej metodike) + Druhý mozog (znalostnú bázu projektu) + Kontextové inžinierstvo (Plan Mode, /compact, prostredie vykonávania). Toto sú 3 piliere, bez ktorých AI halucinuje.

Kompletný pracovný postup pre kontext: klon AI + Druhý mozog + Kontextové inžinierstvo.

Ďalšie materiály nájdete na Ailoot.

Viac podrobností

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.

Všetky články