# Coolify a Claude Code: Nasazení projektu na vlastní VPS > Instalace Coolify, připojení GitHubu, nasazení Next.js, doména a HTTPS, MCP, požadavky na VPS a řešení problémů. Technické ceny v dolarech a původní omezení. Source: https://ailoot.ai/blog/cs/coolify-claude-code-deploy/ Canonical: https://ailoot.ai/blog/cs/coolify-claude-code-deploy/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-087 Revision: sha256-1e90e23cfecd0ae13413619581c20594c7d45d5c2a0989b5b0523ef0e77953cf
[Dokumentace Ailoot](https://ailoot.ai/docs/) — referenční materiály pro práci se službou.
## Omezení platformy a platební podmínky v roce 2026
Hlavní poznatek Bezplatné tarify fungují, dokud poprvé nepřekročíte limit; poté je vyžadována mezinárodní karta. Heroku v roce 2022 uzavřelo svůj bezplatný tarif pro všechny a v únoru 2026 přešlo do režimu udržování. U vlastního Coolify vlastníte server; neplatí se za jednotlivá místa a nejste vázáni na dodavatele.
Typický scénář vibe codera v roce 2026: za večer vytvoříte MVP v Cursoru nebo Claude Code, přesunete ho do repozitáře GitHub, otevřete vercel.com → připojíte repozitář → dostanete se na obrazovku předplatného → zadáte kartu → zobrazí se `Transaction declined`. Nejde o chybu ani dočasný výpadek. Railway, Render, Heroku — všude je to stejné. Heroku skutečně v roce 2022 uzavřelo svůj bezplatný tarif pro všechny a v únoru 2026 projekt přešel do režimu udržování — bez nových funkcí a nových smluv Enterprise. Pro uživatele s nepodporovanou kartou to znamená: „dveře jsou zavřené; obejděte to přes prostředníka, který si účtuje 20% provizi“. Platbu můžete provést přes virtuální karty Visa v Kazachstánu nebo firemní platební služby. To znamená příplatek 20 %, dalších 30 minut u každé transakce a riziko zablokování účtu, pokud platební procesor zjistí nesoulad zemí. Původní příklad zahrnoval tři pokusy — na Vercel Pro, Railway a Render. ## Co je Coolify a jak funguje platforma hostovaná na vlastním serveru?
Hlavní poznatek Coolify je open source PaaS, kterou lze hostovat na vlastním serveru, a přímá alternativa k Heroku, Vercel a Netlify. Nainstaluje se jediným příkazem curl na jakýkoli VPS s Ubuntu. V pozadí využívá Docker + Traefik jako reverzní proxy a Let's Encrypt pro HTTPS. Podporuje integraci s GitHubem, webhooky pro automatické nasazování, zálohy S3 a více než 280 služeb na jedno kliknutí (PostgreSQL, Redis, MinIO). Samostatně hostovaná verze je navždy zdarma a bez omezení. Na GitHubu má 55 800 hvězdiček a licenci Apache-2.0.
Coolify je open source projekt vytvořený pomocí Laravel + Docker, který z jakéhokoli prázdného VPS udělá platformu pro nasazování aplikací. Coolify nainstalujete jednou a všechno ostatní pak řešíte přes webové rozhraní: připojíte GitHub, vyberete repozitář a kliknete na Deploy. Oficiální dokumentace to shrnuje stručně a přesně:

Coolify je open source alternativa k Heroku / Netlify / Vercel atd., kterou lze hostovat na vlastním serveru.

— Coolify GitHub README, https://github.com/coollabsio/coolify
V pozadí se Coolify skládá ze čtyř částí: 1. **Webové rozhraní vytvořené pomocí Laravel 12 + Livewire 3 + Tailwind v4** — dashboard pro správu aplikací. 2. **Docker + Docker Compose** — každá aplikace běží ve vlastním kontejneru, odděleně od ostatních. 3. **Reverzní proxy (Traefik nebo Caddy)** — přijímá příchozí provoz HTTP/HTTPS a směruje ho do kontejnerů. 4. **Integrace Let's Encrypt** — automaticky vydává a obnovuje certifikáty SSL pro všechny domény. Klíčové funkce, díky kterým je Coolify funkčně srovnatelné s Vercel: | Funkce | Vercel | Coolify | |----|----|----| | Automatické nasazení při git push | ✅ | ✅ (přes webhook GitHubu) | | HTTPS zdarma | ✅ | ✅ (Let's Encrypt) | | Náhledová nasazení PR | ✅ | ✅ (přes GitHub App) | | Rozhraní pro proměnné prostředí | ✅ | ✅ | | Zálohy databází | ❌ (nemá vlastní databáze) | ✅ (do úložiště kompatibilního se S3) | | PostgreSQL / Redis / MongoDB | \$20+/měsíc za každou | ✅ Na jedno kliknutí, zdarma | | Plánované úlohy (cron) | ❌ | ✅ (syntaxe cron) | | Platba za jednotlivá místa | \$20/místo/měsíc | Žádná | | Závislost na dodavateli | Vysoká (Edge Functions, ISR) | Žádná (váš Docker) | | Globální CDN | ✅ | ❌ (pouze váš VPS) | Globální CDN je jediná věc, kterou Coolify standardně neobsahuje. To je poctivá odpověď. Pokud má váš projekt globální publikum a potřebujete snížit latenci pro uživatele v USA a Evropě, dejte před něj Cloudflare; pro statický obsah je zdarma. Cena: **samostatně hostovaná verze je navždy zdarma** bez omezení počtu aplikací, serverů ani nasazení. Coolify Cloud je k dispozici za \$5/měsíc za 2 servery + \$3 za každý další — samotné servery jsou ale stále vaše; Coolify Cloud pouze hostuje dashboard. Nejnovější vydání je **v4.1.0 z 18. května 2026**. Mezi nové funkce patří build pack Railpack v beta verzi, auditní záznamy, rozdíly konfigurace mezi nasazeními a nativní endpoint MCP (jen pro čtení). Zdroj: [vydání na GitHubu](https://github.com/coollabsio/coolify/releases). ## Jaký VPS si pořídit pro Coolify v roce 2026?
Hlavní poznatek Coolify vyžaduje minimálně 2 vCPU, 2 GB RAM, 30 GB SSD a Ubuntu LTS (20.04, 22.04 nebo 24.04). Takový VPS zvládne bez problémů provozovat souběžně 3–5 projektů vytvořených pomocí vibe codingu.
Minimální požadavky Coolify pocházejí přímo z [oficiální dokumentace](https://coolify.io/docs/get-started/installation): | Parametr | Minimum | Doporučeno | |-------------|----------------------------------|---------------------------| | CPU | 2 jádra | 2–4 jádra | | RAM | 2 GB | 4 GB (s rezervou pro sestavení) | | Úložiště | 30 GB | 50–80 GB (pro obrazy + databáze) | | Architektura | AMD64 nebo ARM64 (64bitová) | AMD64 | | OS | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS | | Root | Povinný | Přes klíč SSH, ne heslem | Minimum — 2 GB RAM — je **pevná spodní hranice**. S 1 GB se instalátor dostane až k Dockeru, narazí na OOM (nedostatek paměti) a zasekne se. Na RAM nešetřete. Zdroje cen: [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/). Pokud potřebujete vyšší výkon (databázi o velikosti 100 GB, několik instancí Postgres), pořiďte si Aeza Dedicated. Čemu se vyhnout: - **Sdílený VPS s 512 MB–1 GB RAM** — nestačí ani na Coolify. Hodí se pro statické weby na nginxu, ne pro PaaS. Chcete nejen nastavit nasazování, ale také vybudovat **nastavení, díky kterému bude Claude spolehlivý**? Coolify je nástroj pro provádění, ale bez strukturovaného kontextu ([`CLAUDE.md`](https://ailoot.ai/blog/cs/claude-md-template/), [druhého mozku](https://ailoot.ai/blog/cs/claude-code-second-brain/) a [context engineeringu](https://ailoot.ai/blog/cs/context-engineering/)) bude Claude při dlouhých úkolech stále halucinovat. Úplné nastavení zahrnuje všechny tři prvky: **klon AI + druhý mozek + context engineering** — tato kombinace mění Claude z „asistenta, který halucinuje“ ve spolehlivý nástroj. ## Jak nainstalovat Coolify za 5 minut
Hlavní poznatek Instalace probíhá jediným příkazem curl z dokumentace. Po spuštění se na portu 8000 objeví webové rozhraní. V něm vytvoříte prvního uživatele s oprávněním správce a uvidíte prázdný dashboard. Skutečná doba od prázdné instalace Ubuntu po spuštěné Coolify je 5–7 minut, z toho 3–4 minuty zabere `apt-get install docker`. Skript stáhne potřebné závislosti a sám nakonfiguruje Docker; stačí počkat na dokončení.
**Krok 1. Připojte se k VPS přes SSH.** Po vytvoření VPS u poskytovatele se IP adresa serveru a heslo root objeví v e-mailu nebo ovládacím panelu. Připojte se z místního počítače: ```bash ssh root@1.2.3.4 ``` Pokud vám poskytovatel dal klíč SSH místo hesla, připojte se pomocí `-i path/to/key`. Dále předpokládám, že používáte čerstvou instalaci Ubuntu 22.04 nebo 24.04 LTS. **Krok 2. Spusťte instalační příkaz Coolify.** Jeden příkaz z [oficiální dokumentace](https://coolify.io/docs/get-started/installation): ```bash curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash ``` Skript dělá tři věci: 1. Zkontroluje systém (Ubuntu LTS? root? AMD64?) 2. Nainstaluje Docker a Docker Compose, pokud ještě nejsou nainstalovány 3. Stáhne obrazy Coolify (`coolify/coolify`, `coolify/realtime`, `traefik`) a spustí je na pozadí přes docker-compose To trvá 3–5 minut. Uvidíte, jak se vypisují záznamy `apt-get`, po nich `docker pull`. Až se zobrazí `Coolify v4.1.0 is now running`, přejděte ke kroku 3. **Krok 3. Otevřete webové rozhraní.** Otevřete v prohlížeči: ``` http://1.2.3.4:8000 ``` Coolify zobrazí průvodce nastavením — formulář pro vytvoření prvního uživatele. Zadejte e-mail a heslo a uložte je. Tento uživatel se automaticky stane správcem; zatím nepotřebujete žádné další uživatele. Po uložení se dostanete na prázdný dashboard: vlevo postranní panel s položkami Resources / Projects / Servers / Sources / Notifications / Settings a uprostřed výzva „Add your first resource“. **Krok 4. Otevřete porty ve firewallu poskytovatele (ne v UFW).** Coolify už běží, ale zvenčí je dostupný pouze port 8000 (dashboard). Aby se uživatelé dostali k vašim aplikacím, musíte otevřít porty 80 (HTTP) a 443 (HTTPS): | Port | Účel | |----|----| | 22 | Přístup k serveru přes SSH | | 80 | Přijímá provoz HTTP, nutný pro ověření Let's Encrypt | | 443 | Přijímá provoz uživatelů přes HTTPS | | 8000 | Dashboard Coolify (po nastavení vlastní domény pro dashboard ho zavřeme) | Důležité úskalí z oficiální dokumentace:

Docker používá pravidla iptables založená na NAT, která mohou obejít tradiční linuxové firewally, jako je UFW.

— Dokumentace Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall
To znamená, že i když zapnete UFW a zavřete všechny porty, Docker bude dál vystavovat své kontejnery přes iptables. UFW je zde k ničemu. Řešením je **otevírat a zavírat porty v ovládacím panelu poskytovatele**, nikoli přes UFW. U Timeweb / Selectel / Aeza to provedete v části „Network → Firewall“ webové konzole. **Krok 5 (volitelný). Nasměrujte dashboard na svou doménu.** Chcete-li navštěvovat `https://coolify.example.com` místo `http://1.2.3.4:8000`, vytvořte DNS záznam A `coolify.example.com → 1.2.3.4`, přejděte v Coolify na **Settings → Instance Settings → Instance Domain**, zadejte svou subdoménu a uložte ji. Coolify si vyžádá certifikát Let's Encrypt a za minutu znovu načte dashboard přes HTTPS. Poté můžete ve firewallu zavřít port 8000 — dashboard bude dostupný přes HTTPS na standardním portu 443. ## Jak připojit GitHub: App, nebo PAT?
Hlavní poznatek Coolify podporuje dva způsoby připojení GitHubu: **GitHub App** (doporučený) a **Personal Access Token (PAT)**. Použijte GitHub App: nastavení pomocí průvodce trvá 5 minut, fungují náhledy PR a oprávnění lze přesně omezit na úrovni repozitáře. PAT je zastaralá možnost pro starší případy; nepodporuje náhledová nasazení a hrozí u něj globální přístup ke všem vašim repozitářům. Oficiální dokumentace říká přímo: „pro 95 % uživatelů je správnou volbou GitHub App“.
V Coolify přejděte na **Sources → + Add → GitHub App**. Coolify zobrazí tříobrazovkového průvodce: 1. **Name & description** — pojmenujte zdroj (zadejte `github-main`) a případně přidejte popis. 2. **Configure on GitHub** — tlačítko vás přenese na GitHub.com a automaticky otevře formulář pro vytvoření GitHub App se správnými oprávněními. 3. **Confirm** — po návratu z GitHubu klikněte na „Save“. Ve druhém kroku vás GitHub požádá o potvrzení oprávnění, která Coolify požaduje: | Oprávnění | Úroveň | Účel | |-----------------|------------|----------------------------------------------| | Contents | Pouze pro čtení | Klonování repozitáře | | Pull Requests | Čtení a zápis | Vytváření náhledových nasazení a komentování PR | | Email addresses | Pouze pro čtení | Identifikace commitů | | Metadata | Pouze pro čtení | Výpis repozitářů | Jde o **minimální oprávnění** — GitHub App nevidí vaše soukromé klíče, nemůže zapisovat do `main` a nemá přístup k repozitářům, které jste výslovně nepřipojili. Z oficiální dokumentace: Personal Access Token (PAT) je stará metoda; **nedoporučuji ho používat**. Nevýhody: - PAT poskytuje globální přístup ke všem vašim repozitářům (včetně soukromých) - Náhledy PR nefungují — tato funkce je dostupná pouze s GitHub App - Token má dlouhou platnost (90 dní, rok nebo neomezeně) — pokud unikne, je to problém PAT používejte pouze tehdy, když pracujete s repozitářem organizace, jejíž bezpečnostní pravidla zakazují GitHub Apps a neexistuje způsob, jak to obejít. Po uložení zdroje v Coolify uvidíte na dashboardu GitHub App se seznamem připojených repozitářů. Při vytváření nové aplikace budete moci kterýkoli z nich vybrat jediným kliknutím. ## Jak nasadit projekt Next.js z Claude Code v 6 krocích
Hlavní poznatek Kompletní cesta od prázdného nastavení Claude Code po spuštěný web: 1) spusťte `claude` v prázdné složce, popište projekt a Claude vygeneruje kód; 2) spusťte `git init && git remote add` (Claude to může udělat sám pomocí slash příkazu); 3) odešlete změny na GitHub; 4) v Coolify vyberte „+ New Resource → Application“ a zvolte repozitář; 5) přidejte proměnné prostředí; 6) klikněte na Deploy. Coolify rozpozná Next.js, vybere build pack Nixpacks, sestaví obraz Dockeru za 3–5 minut a poskytne dočasnou doménu s HTTPS již v základu.
**Krok 1. Popište projekt Claude Code v prázdné složce.** ```bash mkdir my-vibe-app cd my-vibe-app git init claude ``` V relaci zadejte: ``` Vytvoř projekt Next.js 14 app router: - domovskou stránku se seznamem uživatelů - endpoint /api/users, který vrací pole z databáze - Postgres přes Prisma - Tailwind pro styly - .env.example s DATABASE_URL - README.md s pokyny ke spuštění projektu ``` Claude vygeneruje strukturu souborů, package.json, prisma/schema.prisma a .env.example. Požádejte také: ``` Vytvoř Dockerfile pro produkční sestavení a soubor .dockerignore. ``` To je volitelné — Coolify sestaví projekt pomocí Nixpacks i bez Dockerfile. Dockerfile vám ale dává kontrolu nad procesem a u větších projektů je rychlejší. **Krok 2. Vytvořte repozitář GitHub a odešlete do něj změny.** Můžete to udělat ručně přes rozhraní GitHubu + `git remote add origin ...`, ale Claude Code to zvládne sám: ``` /commit-push-pr Initial Next.js app generated with Claude Code ``` Nebo jednoduše řekněte: „Commit everything and push it to a new repository `my-vibe-app` under my account.“ Claude použije nástroj `gh` CLI k vytvoření soukromého (nebo veřejného) repozitáře a provedení prvního push. Zdroj: [oficiální příkaz Claude Code](https://github.com/anthropics/claude-code/blob/main/.claude/commands/commit-push-pr.md). **Krok 3. Vytvořte aplikaci v Coolify.** Na dashboardu Coolify klikněte na **+ New → Application**. Otevře se formulář: 1. **Source** — vyberte `github-main` (GitHub App připojenou v předchozí části H2) 2. **Repository** — ze seznamu vyberte `my-vibe-app` 3. **Branch** — `main` 4. **Build Pack** — Coolify ho automaticky rozpozná. Pokud existuje Dockerfile, použije `dockerfile`. Jinak použije `nixpacks`. Výběr můžete ručně změnit. 5. **Domain** — zatím ponechte navrženou dočasnou hodnotu; později ji nahradíte vlastní 6. **Port** — ve výchozím nastavení `3000` pro Next.js Uložte. **Krok 4. Přidejte proměnné prostředí.** V aplikaci otevřete kartu **Environment Variables**. Proměnné přidávejte jednu po druhé: ``` DATABASE_URL=postgresql://user:pass@db-host:5432/mydb NODE_ENV=production ANTHROPIC_API_KEY=sk-ant-... ``` Pokud nemáte databázi, vytvořte ji přímo v Coolify: **+ New → Database → PostgreSQL**. Coolify spustí kontejner Postgres za 30 sekund a poskytne interní DATABASE_URL ve formátu `postgresql://postgres:pass@postgres-xyz:5432/postgres` — zadejte ho do aplikace. Všechny proměnné jsou v databázi Coolify šifrované a nezobrazují se v záznamech sestavení. **Krok 5. Klikněte na Deploy.** Vpravo nahoře je modré tlačítko Deploy. V kartě Logs se zobrazí ž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 the temporary domain [stage: ssl] Let's Encrypt cert issued for the temporary domain ``` První sestavení trvá 3–5 minut (stáhne základní obraz Node a nainstaluje závislosti). Další sestavení trvají 60–90 sekund díky cachování vrstev Dockeru. Až se stav změní na **Running**, zkopírujte URL aplikace z pole **Domains** v Coolify a otevřete přesně tuto adresu. Níže ji používejte jako ``; označení v ostrých závorkách je zástupný údaj, nikoli skutečná adresa. Měla by se zobrazit domovská stránka s HTTPS již v základu. Coolify používá bezplatnou službu wildcard DNS pro dočasné domény, abyste mohli web otevřít hned bez nastavování vlastního DNS. **Krok 6. Ověřte, že všechno funguje.** Otevřete URL aplikace z předchozího kroku s přidaným `/api/users`, například `/api/users`, bez zdvojení lomítka. Je to endpoint JSON vytvořený v kroku 1; kořenová URL aplikace je domovská stránka. Pokud se objeví chyba 500, v kartě Logs uvidíte trasování zásobníku. Nejčastějším problémem prvního nasazení je, že DATABASE_URL ukazuje na neexistující databázi. Opravíte to vytvořením instance PostgreSQL v Coolify (viz krok 4 výše) a nahrazením DATABASE_URL. 15 minut od okamžiku objednání VPS. V původním příkladu tento postup na novém serveru trval 12–18 minut. ## Jak nastavit vlastní doménu a HTTPS
Hlavní poznatek Vlastní doménu připojíte ve 3 krocích: vytvořte DNS záznam A směřující na IP serveru, v konfiguraci Coolify zadejte svou doménu místo dočasné domény, zapněte Automatic HTTPS a klikněte na Redeploy. Let's Encrypt automaticky vydá certifikát SSL 2–3 minuty po propagaci DNS (obvykle 5–30 minut). Klíčové je, aby se DNS překládalo už ve chvíli, kdy kliknete na Redeploy; jinak ověření Let's Encrypt selže a na další pokus budete muset čekat 12 minut.
**Krok 1. Vytvořte DNS záznam A v ovládacím panelu registrátora.** Původní příklady používají domény hostované u Reg.ru, Beget nebo Timeweb. Postup je stejný: | Typ záznamu | Název | Hodnota | |------------|---------------------------|------------------------| | A | `app` (nebo `@` pro kořenovou doménu) | `1.2.3.4` (IP serveru) | Uložte záznam, otevřete konzoli a zkontrolujte: ```bash dig app.example.com +short # Mělo by vrátit 1.2.3.4 ``` Pokud se nic nevrátí nebo se vrátí jiná IP, DNS se ještě nepropagovalo. Počkejte 5–30 minut. **Krok 2. Zadejte doménu v Coolify.** V aplikaci otevřete kartu **Configuration → General**. V poli **Domains** nahraďte dočasnou URL aplikace zkopírovanou z Coolify hodnotou `https://app.example.com` se svou skutečně nastavenou doménou. Zapněte **Automatic HTTPS** (obvykle je zapnuté už ve výchozím nastavení). Uložte změny a klikněte na **Redeploy**. **Krok 3. Počkejte na certifikát Let's Encrypt.** V záznamech sestavení se zobrazí: ``` [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 ``` Za 2–3 minuty bude web dostupný na `https://app.example.com` a v adresním řádku uvidíte zelený zámek. Co se může pokazit u Let's Encrypt (3 nejčastější problémy podle [oficiálního průvodce řešením problémů](https://coolify.io/docs/troubleshoot/dns-and-domains/lets-encrypt-not-working)): 1. **Port 80 je ve firewallu zavřený.** Let's Encrypt ověřuje pomocí HTTP challenge — odešle požadavek na `http://app.example.com/.well-known/acme-challenge/xxx`. Bez portu 80 ověření neprojde. Otevřete ho ve firewallu poskytovatele. 2. **Je zapnutá proxy Cloudflare (oranžový mrak).** Zachytí požadavek Let's Encrypt a vrátí vlastní zástupnou stránku — ověření selže. Řešením je přepnout na režim „DNS only“ (šedý mrak) nebo nakonfigurovat challenge DNS-01 přes API Cloudflare. 3. **DNS se ještě nepropagovalo.** Pokud jste záznam A vytvořili před 30 sekundami a hned klikli na Redeploy, Let's Encrypt vaši doménu neuvidí. Počkejte 5–30 minut, než se DNS rozšíří mezi servery. Limit Let's Encrypt: **5 neúspěšných pokusů za hodinu pro jednu doménu**, obnova probíhá rychlostí 1 pokus každých 12 minut. Pokud limitu dosáhnete, neklikejte desetkrát po sobě na Redeploy; zkontrolujte záznamy, opravte problém a zkuste to znovu za 12 minut. ## Jak Claude Code spravuje Coolify přes MCP?
Hlavní poznatek Prostřednictvím Model Context Protocol získá Claude Code přímý přístup k API Coolify — můžete zadat „nasadit tuto aplikaci“ a spustit sestavení, zkontrolovat stav, číst záznamy nebo aktualizovat proměnné prostředí. Existují tři možnosti: forsonny/Coolify-MCP-Server (základní, 7 kategorií operací), dazeb/coolify-mcp-enhanced (více než 15 dalších nástrojů včetně nasazení databáze na jedno kliknutí) a ajmcclary/Coolify-Manager (dovednost Claude vytvořená kolem oficiálního CLI). Od verze v4.1.0 (18. května 2026) nabízí Coolify nativní endpoint MCP bez serverů třetích stran — zatím je však pouze pro čtení.
Model Context Protocol (MCP) je standard společnosti Anthropic, který umožňuje Claude Code komunikovat s externími systémy (více se dozvíte v [průvodci servery MCP](https://ailoot.ai/blog/cs/mcp-servers-claude-code/)). Připojte server MCP a Claude získá sadu nástrojů, které může volat. Pro Coolify existují tři hotové servery a jedna nativní možnost. **Možnost 1. forsonny/Coolify-MCP-Server-for-Claude-Code — základní.** Co umí: - **Aplikace:** vytvořit, spustit, zastavit, restartovat - **Služby:** zobrazit seznam, vytvořit, spustit/zastavit/restartovat - **Nasazení:** zobrazit spuštěná, vyhledat podle UUID - **Týmy a členové:** zobrazit seznam, získat informace - **Klíče SSH:** zobrazit seznam, vytvořit - **Proměnné prostředí:** úplné CRUD pro aplikace a služby - **Přehled serveru:** domény na serveru, stav, verze Instalace: ```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 ``` Poté můžete v Claude Code zadat: ``` Zobraz stav aplikace my-vibe-app v Coolify a 3 nejnovější nasazení. ``` Claude vrátí tabulku. **Možnost 2. dazeb/coolify-mcp-enhanced — rozšířená (doporučeno).** Co přidává k základní sadě: - **Nasazení PostgreSQL / Redis / MinIO na jedno kliknutí** pomocí AI — řekněte „nastav mi Postgres“ a vytvoří kontejner a vrátí DATABASE_URL - **Monitorování v reálném čase + využití prostředků** — CPU/RAM každé aplikace v reálném čase - **Hromadné aktualizace konfigurace env** — aktualizace 20 proměnných jedním příkazem - **Podpora Docker Compose** — nasazování aplikací s více službami Konfigurace pro Claude Code (`.mcp.json` v kořeni 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žnost 3. ajmcclary/Coolify-Manager — dovednost Claude vytvořená kolem CLI.** Nejde o server MCP, ale o dovednost Claude Code, která obaluje oficiální CLI Coolify. Obsahuje: - Diagnostiku stavu služeb a kontejnerů - Diagnostiku certifikátů SSL - Podporu více instancí (pokud máte několik serverů Coolify) - Postupy řešení problémů Instalace: stáhněte dovednost a umístěte ji do `~/.claude/skills/coolify-manager/`. Claude Code ji načte a nabídne pro relevantní úlohy. **Možnost 4 (novinka z května 2026). Nativní MCP v Coolify v4.1.0.** Záznam změn v4.1.0 z 18. května 2026 uvádí: > Přidána podpora MCP na úrovni instance s nástroji pouze pro čtení pro prostředky Coolify a API/UI. Coolify nyní poskytuje vlastní endpoint MCP — Claude Code můžete připojit přímo bez serverů třetích stran. Zatím je **pouze pro čtení** (seznamy aplikací, stavy, konfigurace), bez operací pro provádění změn. To ale stačí na většinu úloh typu „řekni mi něco o infrastruktuře“. Připojte ho přes `.mcp.json`: ```json { "mcpServers": { "coolify-native": { "url": "https://coolify.example.com/api/v1/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Na plný přístup pro zápis v nativním MCP počkejte do verze v4.2 nebo v4.3 — tým Coolify ho slíbil do konce roku 2026. ## 5 úskalí prvního nasazení — a jak se jim vyhnout
Hlavní poznatek Nejčastější chyby při prvním nasazení jsou nedostatek RAM, zavřený port 80, proxy Cloudflare narušující ověření Let's Encrypt, nefunkční ochrana Dockeru přes UFW a volba PAT místo GitHub App. Všechny jsou popsané v oficiální dokumentaci, ale bez praktických zkušeností na ně snadno narazíte. Níže najdete kontrolní seznam o 5 bodech vycházející z původní zkušenosti s první instalací Coolify.
**Úskalí 1: Méně než 2 GB RAM — instalace selže s OOM.** Příznak: `curl install.sh` dojde k `docker pull coolify/coolify`, zastaví se na 70 % a proces je ukončen hlášením `Killed (signal 9)`. Záznamy `dmesg | tail` ukazují `Out of memory: Killed process`. Řešení: ```bash # Vytvořte 4 GB odkládací soubor pro dočasné řešení 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 ``` Dlouhodobě přejděte na 4 GB RAM. Coolify funguje se swapem, ale sestavení velkých projektů Next.js může selhat. **Úskalí 2: UFW je zapnutý, ale Docker dál otevírá porty.** Příznak: zapnuli jste UFW a zavřeli všechny porty kromě 22, přesto je vaše aplikace z internetu dostupná na nějakém náhodném portu (například 3000). Důvod podle [oficiální dokumentace](https://coolify.io/docs/knowledge-base/server/firewall):

Coolify běží na Dockeru, který používá pravidla iptables založená na NAT a může obejít tradiční linuxové firewally, jako je UFW.

— Dokumentace Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall
Řešení: použijte **firewall v ovládacím panelu poskytovatele**, nikoli UFW. Timeweb / Selectel / Aeza mají sekci „Firewall“ nebo „Network → Firewall“, kde nastavíte pravidla na úrovni virtuální sítě — ta se uplatní dřív, než pakety dorazí k Dockeru. Alternativou je ufw-docker, skript, který upraví UFW pro kompatibilitu s Dockerem. Je to ale složitější než kliknutí v ovládacím panelu. **Úskalí 3: Proxy Cloudflare (oranžový mrak) narušuje Let's Encrypt.** Příznak: po kliknutí na Redeploy záznamy ukazují `Let's Encrypt validation failed - challenge returned 403`. Důvod: Cloudflare proxy předá HTTP požadavek Let's Encrypt a místo vašeho souboru s výzvou vrátí vlastní stránku. Řešení — vyberte jednu ze dvou možností: 1. **Přepněte na „DNS only“** (šedý mrak v Cloudflare). Nevýhoda: přijdete o CDN a ochranu Cloudflare. 2. **Nakonfigurujte challenge DNS-01 přes API Cloudflare.** V Coolify přejděte na Settings → SSL Configuration, vyberte poskytovatele Cloudflare a zadejte API token s oprávněními Zone:Read a DNS:Edit. Let's Encrypt ověří doménu přes záznam TXT místo HTTP. Druhá možnost se nastavuje složitěji, ale zachová proxy Cloudflare. **Úskalí 4: PAT místo GitHub App — náhledy PR nefungují.** Příznak: připojili jste GitHub pomocí Personal Access Token; všechno funguje, ale pro PR se nevytvářejí náhledová nasazení. Otevřeli jste PR v GitHubu, ale v Coolify se nic neobjevilo. Důvod: náhledy PR jsou výhradní funkcí GitHub App. PAT nedostává přes webhook události `pull_request`. Řešení: znovu připojte GitHub přes App. Sources → Add → GitHub App → dokončete průvodce. Starý zdroj PAT můžete odstranit. **Úskalí 5: „Coolify == Vercel“ není úplně přesné.** Co Coolify standardně **nedělá**: | Vercel | Coolify | Co dělat | |----|----|----| | Globální CDN | Ne | Dejte před něj Cloudflare (zdarma pro statický obsah) | | Incremental Static Regeneration | Ne | `revalidatePath` funguje pouze na vašem serveru | | Optimalizace obrázků | Ne | Použijte `next/image` s místním loaderem nebo Cloudflare Images | | Automatické škálování při špičkách | Ne | Škálujte ručně; upgradujte VPS | | Edge Functions | Ne | Používejte běžné API routes | Pokud je váš projekt SaaS s vysokou návštěvností, globálním publikem a požadavkem na latenci \< 100 ms po celém světě, Coolify se nehodí; zvolte Vercel Enterprise. Pokud jste vibe coder s MVP, které testujete na 100–1 000 uživatelích denně, Coolify pokryje všechno. Z poctivé analýzy samostatného hostování: 15 minut v názvu tohoto návodu označuje ideální průběh prvního nasazení jednoho projektu. Kompletní nastavení infrastruktury včetně monitorování, záloh a upozornění zabere jeden nebo dva večery. Buďte k sobě upřímní. ## Kolik za rok ušetříte ve srovnání s Vercel?
Hlavní poznatek Počítejte také se „skrytou časovou daní“ ve výši 5–10 hodin na počáteční nastavení a 1–2 hodin měsíčně na údržbu.
Čísla Vercel níže jsou odhady scénářů článku z května 2026, nikoli aktuální nabídky. Tvoří jen jednu stranu porovnání. Vlastní Coolify nemá licenční poplatek, ale VPS, zálohy, úložiště, přenosy a provoz dál stojí peníze. Získejte nabídku splňující požadavky výše; číselná cena VPS ve scénářích chybí, proto by pevná úspora nebyla doložená. Nechť **C** je celkový měsíční účet VPS, záložního úložiště, dodatečných přenosů, monitoringu a případného placeného dashboardu. Každý výdaj zahrňte jednou. **r** je hodinová cena správy ve stejné měně. Odhad času článku je 5–10 hodin na začátku plus 1–2 hodiny měsíčně: **17–34 hodin v prvním roce** a **12–24 hodin v dalších letech**. | Scénář | Odhad Vercel/měsíc | Vercel/rok | Infrastruktura Coolify/měsíc | Celkové náklady Coolify první rok včetně práce | Úspora proti Vercel první rok | |----|----|----|----|----|----| | Jeden prototyp, 100,000 návštěv/měsíc | $20 základ + ~$5 přenosy = $25 | $300 | C | 12C + (17–34)r | $300 − 12C − (17–34)r | | Pět projektů na jednom VPS | $20 základ + $30 přenosy/funkce = $50 | $600 | C | 12C + (17–34)r | $600 − 12C − (17–34)r | | Tři vývojáři, pět projektů | $60 místa + $30 přenosy = $90 | $1,080 | C | 12C + (17–34)r | $1,080 − 12C − (17–34)r | Vyžadují-li scénáře jinak velké servery, použijte samostatné C. Po rozložení počáteční práce do 12 měsíců je měsíční ekvivalent prvního roku **C + (17–34)r/12**. Další rok stojí **12C + (12–24)r**. Vzorce porovnávají uvedený odhad Vercel s vlastním hostingem; srovnatelnou správu zahrňte i u Vercel. Záporná úspora znamená dražší vlastní hosting. Nezapočítávejte znovu celý plat stejného inženýra, pokud jej r již obsahuje. Před přechodem doplňte C ze skutečné nabídky poskytovatele a plánu záloh, zvolte r a porovnejte skutečnou měsíční spotřebu. Bez těchto vstupů článek poskytuje nákladový model, nikoli dolarovou úsporu. Hlavní přínos nejsou peníze. Po přechodu na Coolify **zmizí kategorie „závislost na cizí platební politice“**. Virtuální zprostředkující karty s 20% provizí už nejsou potřeba. Coolify není levnější Vercel. Je to jiná kategorie produktu: vlastníte infrastrukturu, přebíráte za ni odpovědnost a výsledek nákladového porovnání závisí na vašich vstupech a složitějším provozu. Pokud je nasazení prototypu vaším prvním úkolem po vytvoření projektu v Claude Code, pak správa prostředí (env, tajné údaje, plánované úlohy, zálohy) patří do [**context engineeringu**](https://ailoot.ai/blog/cs/context-engineering/). Bez struktury určující, „kde co leží“, se Claude ztratí a při každé změně ztrácíte čas. Úplné nastavení zahrnuje: **klon AI** ([Skills](https://ailoot.ai/blog/cs/claude-code-skills-library/) a [Subagents](https://ailoot.ai/blog/cs/claude-code-subagents/) přizpůsobené vaší metodice) + [**druhý mozek**](https://ailoot.ai/blog/cs/claude-code-second-brain/) (znalostní báze projektu) + **Context Engineering** ([Plan Mode](https://ailoot.ai/blog/cs/claude-code-plan-mode/), `/compact`, prostředí pro provádění). To jsou **3 pilíře**, bez kterých AI halucinuje.
### Zdroje - [Oficiální dokumentace Coolify: Úvod](https://coolify.io/docs/get-started/introduction) - [Průvodce instalací Coolify](https://coolify.io/docs/get-started/installation) - [Přehled build packů Coolify](https://coolify.io/docs/applications/build-packs/overview) - [Znalostní báze Coolify k firewallu](https://coolify.io/docs/knowledge-base/server/firewall) - [Řešení problémů s Let's Encrypt v Coolify](https://coolify.io/docs/troubleshoot/dns-and-domains/lets-encrypt-not-working) - [Ceník Coolify](https://coolify.io/pricing) - [Coolify na GitHubu: vydání v4.1.0](https://github.com/coollabsio/coolify/releases) - [Přehled 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/) - [Ceník Vercel](https://vercel.com/pricing)
Kompletní kontextový workflow: **klon AI + druhý mozek + context engineering**. Další materiály najdete na [Ailoot](https://ailoot.ai/). ## Časté otázky ### Která URL má po nasazení vrátit JSON? Z pole Domains v Coolify zkopírujte URL aplikace a otevřete její cestu /api/users. Kořenová URL je domovská stránka; /api/users je endpoint JSON zadaný v ukázkovém projektu. ### Jak vypočítat úsporu vlastního hostingu? Do C sečtěte měsíční VPS, zálohy, úložiště, přenosy, monitoring a volitelný dashboard. První rok stojí 12C plus 17–34 hodin za vaši hodinovou cenu; porovnejte roční odhad Vercel a srovnatelné provozní náklady na obou stranách. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.