Coolify a Claude Code: Nasazení projektu na vlastní VPS
MarkdownInstalace 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í.
Přečíst celý článek
Dokumentace Ailoot — 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.
V pozadí se Coolify skládá ze čtyř částí:
- Webové rozhraní vytvořené pomocí Laravel 12 + Livewire 3 + Tailwind v4 — dashboard pro správu aplikací.
- Docker + Docker Compose — každá aplikace běží ve vlastním kontejneru, odděleně od ostatních.
- Reverzní proxy (Traefik nebo Caddy) — přijímá příchozí provoz HTTP/HTTPS a směruje ho do kontejnerů.
- 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.
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:
| 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, FirstVDS a Selectel.
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, druhého mozku a context engineeringu) 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:
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:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
Skript dělá tři věci:
- Zkontroluje systém (Ubuntu LTS? root? AMD64?)
- Nainstaluje Docker a Docker Compose, pokud ještě nejsou nainstalovány
- 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.
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:
- Name & description — pojmenujte zdroj (zadejte
github-main) a případně přidejte popis. - 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.
- 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.
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.
Krok 3. Vytvořte aplikaci v Coolify.
Na dashboardu Coolify klikněte na + New → Application. Otevře se formulář:
- Source — vyberte
github-main(GitHub App připojenou v předchozí části H2) - Repository — ze seznamu vyberte
my-vibe-app - Branch —
main - Build Pack — Coolify ho automaticky rozpozná. Pokud existuje Dockerfile, použije
dockerfile. Jinak použijenixpacks. Výběr můžete ručně změnit. - Domain — zatím ponechte navrženou dočasnou hodnotu; později ji nahradíte vlastní
- Port — ve výchozím nastavení
3000pro 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 '<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 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 <app-url-from-coolify>; 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 <app-url-from-coolify>/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:
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ů):
- 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. - 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.
- 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). 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:
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
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):
{
"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:
{
"mcpServers": {
"coolify-native": {
"url": "https://coolify.example.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
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í:
# 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:
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.
Ř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í:
- Přepněte na „DNS only“ (šedý mrak v Cloudflare). Nevýhoda: přijdete o CDN a ochranu Cloudflare.
- 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. 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 a Subagents přizpůsobené vaší metodice) + druhý mozek (znalostní báze projektu) + Context Engineering (Plan Mode, /compact, prostředí pro provádění). To jsou 3 pilíře, bez kterých AI halucinuje.
Zdroje
Kompletní kontextový workflow: klon AI + druhý mozek + context engineering.
Další materiály najdete na Ailoot.
Další podrobnosti
Č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.