Coolify in Claude Code: Uvedite projekt na svoj VPS
MarkdownNamestitev Coolify, povezava z GitHubom, uvajanje Next.js, domena in HTTPS, MCP, zahteve za VPS ter odpravljanje težav. Tehnične cene v dolarjih in izvirne omejitve.
Preberi celoten članek
Dokumentacija Ailoot — referenčno gradivo za delo s storitvijo.
Omejitve platform in pogoji plačevanja v letu 2026
Ključna ugotovitev
Brezplačni paketi delujejo, dokler prvič ne presežete omejitve; po tem potrebujete mednarodno kartico. Heroku je leta 2022 vsem zaprl brezplačni paket, februarja 2026 pa je prešel v način vzdrževanja. Pri samostojno gostovanem Coolifyju je strežnik vaš; ni obračunavanja na uporabniško mesto in ni vezanosti na ponudnika.
Značilen scenarij za vibe coding v letu 2026: v enem večeru ustvarite MVP v Cursorju ali Claude Code, ga prenesete v repozitorij GitHub, odprete vercel.com → povežete repozitorij → pridete do zaslona za naročnino → vnesete kartico → prejmete Transaction declined.
To ni napaka ali začasen izpad.
Railway, Render, Heroku — zgodba je enaka. Heroku je dejansko vsem zaprl brezplačni paket leta 2022, februarja 2026 pa je projekt prešel v način vzdrževanja — brez novih funkcij in novih pogodb Enterprise. Za uporabnika z nepodprto kartico to pomeni: »vrata so zaprta; pojdite okoli prek posrednika, ki zaračuna 20-odstotno provizijo.«
Plačate lahko z virtualnimi karticami Visa v Kazahstanu ali prek poslovnih plačilnih storitev. Toda to pomeni 20 % višjo ceno, 30 minut več za vsako transakcijo in tveganje, da vam bodo blokirali račun, ko bo ponudnik plačil opazil neskladje med državama.
Izvirni primer je vključeval tri poskuse — na Vercel Pro, Railway in Render.
Kaj je Coolify in kako deluje platforma za samostojno gostovanje?
Ključna ugotovitev
Coolify je odprtokodni PaaS, ki ga lahko gostite sami, in neposredna alternativa Herokuju, Vercelu in Netlifyju. Namesti se z enim samim ukazom curl na katerem koli VPS-u z Ubuntujem. V ozadju uporablja Docker + Traefik za povratni posrednik in Let's Encrypt za HTTPS. Podpira integracijo z GitHubom, webhooke za samodejne uvedbe, varnostne kopije S3 in več kot 280 storitev, ki jih namestite z enim klikom (PostgreSQL, Redis, MinIO). Samostojno gostovana različica je za vedno brezplačna, brez omejitev. Na GitHubu ima 55,800 zvezdic in licenco Apache-2.0.
Coolify je odprtokodni projekt, zgrajen z Laravelom + Dockerjem, ki kateri koli prazen VPS spremeni v platformo za uvajanje aplikacij. Coolify namestite enkrat, nato pa vse drugo opravite prek spletnega vmesnika: povežete GitHub, izberete repozitorij in kliknete Deploy.
Uradna dokumentacija to pove kratko in natančno:
Coolify je odprtokodna alternativa Herokuju / Netlifyju / Vercelu itd., ki jo lahko gostite sami.
Coolify je v ozadju sestavljen iz štirih delov:
- Spletni vmesnik, zgrajen z Laravel 12 + Livewire 3 + Tailwind v4 — nadzorna plošča za upravljanje aplikacij.
- Docker + Docker Compose — vsaka aplikacija se izvaja v vsebniku, ločeno od drugih.
- Povratni posrednik (Traefik ali Caddy) — sprejema dohodni promet HTTP/HTTPS in ga usmerja do vsebnikov.
- Integracija z Let's Encrypt — samodejno izda in obnavlja potrdila SSL za vse domene.
Ključne funkcije, zaradi katerih je Coolify po funkcionalnosti primerljiv z Vercelom:
| Funkcija | Vercel | Coolify |
|---|---|---|
| Samodejna uvedba ob git push | ✅ | ✅ (prek webhooka GitHub) |
| Brezplačni HTTPS | ✅ | ✅ (Let's Encrypt) |
| Uvedbe predogleda PR | ✅ | ✅ (prek GitHub App) |
| Uporabniški vmesnik za spremenljivke okolja | ✅ | ✅ |
| Varnostne kopije podatkovnih baz | ❌ (nima lastnih podatkovnih baz) | ✅ (v shrambo, združljivo s S3) |
| PostgreSQL / Redis / MongoDB | $20+/mesec za vsako | ✅ En klik, brezplačno |
| Načrtovana opravila (cron) | ❌ | ✅ (sintaksa cron) |
| Obračunavanje na uporabniško mesto | $20/uporabniško mesto/mesec | Brez stroškov |
| Vezanost na ponudnika | Visoka (Edge Functions, ISR) | Nič (vaš Docker) |
| Globalni CDN | ✅ | ❌ (samo vaš VPS) |
Globalni CDN je edina stvar, ki je Coolify ne vključuje že ob namestitvi. To je pošten odgovor. Če ima vaš projekt globalno občinstvo in morate zmanjšati zakasnitve za uporabnike v ZDA in Evropi, postavite Cloudflare pred njega; za statično vsebino je brezplačen.
Cena: samostojno gostovana različica je za vedno brezplačna, brez omejitev glede števila aplikacij, strežnikov ali uvedb. Coolify Cloud je na voljo za $5/mesec za 2 strežnika + $3 za vsakega dodatnega — vendar so strežniki še vedno vaši; Coolify Cloud gosti samo nadzorno ploščo.
Najnovejša izdaja je v4.1.0 z dne 18. maja 2026. Med novimi funkcijami so gradbeni paket Railpack v beta različici, revizijsko beleženje, primerjave konfiguracij med uvedbami in vgrajena končna točka MCP (samo za branje). Vir: izdaje na GitHubu.
Kateri VPS izbrati za Coolify v letu 2026?
Ključna ugotovitev
Coolify potrebuje najmanj 2 vCPU, 2 GB RAM-a, 30 GB SSD-ja in Ubuntu LTS (20.04, 22.04 ali 24.04). Tak VPS lahko udobno poganja 3–5 projektov, ustvarjenih z vibe codingom, hkrati.
Minimalne zahteve Coolifyja izhajajo neposredno iz uradne dokumentacije:
| Parameter | Najmanj | Priporočeno |
|---|---|---|
| CPU | 2 jedri | 2–4 jedra |
| RAM | 2 GB | 4 GB (z nekaj rezerve za gradnje) |
| Shramba | 30 GB | 50–80 GB (za slike + podatkovne baze) |
| Arhitektura | AMD64 ali ARM64 (64-bit) | AMD64 |
| OS | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS |
| Root | Obvezen | S ključem SSH, ne z geslom |
Minimum — 2 GB RAM-a — je trda spodnja meja. Z 1 GB namestitveni program pride do Dockerja, naleti na OOM (zmanjka pomnilnika) in obvisi. Pri RAM-u ne varčujte.
Viri cen: Timeweb Cloud, FirstVDS in Selectel.
Če potrebujete več zmogljivosti (podatkovno bazo velikosti 100 GB, več instanc Postgresa), izberite Aeza Dedicated.
Česa ne izbrati:
- Deljeni VPS z 512 MB–1 GB RAM-a — premalo celo za Coolify. Namenjen je statičnim stranem na nginxu, ne platformi PaaS.
Želite poleg nastavitve uvajanja zgraditi tudi nastavitev, zaradi katere je Claude zanesljiv? Coolify je orodje za izvajanje, toda brez strukturiranega konteksta (CLAUDE.md, drugega možgana in kontekstnega inženiringa) bo Claude pri dolgih opravilih še vedno haluciniral. Popolna nastavitev vključuje vse tri: klon AI + drugi možgani + kontekstni inženiring — ta kombinacija spremeni Claude iz »pomočnika, ki halucinira« v zanesljivo orodje.
Kako namestiti Coolify v 5 minutah
Ključna ugotovitev
Za namestitev potrebujete en sam ukaz curl iz dokumentacije. Ko se zažene, se na vratih 8000 prikaže spletni vmesnik. Tam ustvarite prvega skrbniškega uporabnika in vidite prazno nadzorno ploščo. Od prazne namestitve Ubuntuja do delujočega Coolifyja v resnici mine 5–7 minut, od tega 3–4 minute porabite za apt-get install docker. Skript sam prenese potrebne odvisnosti in konfigurira Docker; počakati morate le, da konča.
1. korak. Povežite se z VPS-om prek SSH.
Ko pri ponudniku ustvarite VPS, se naslov IP strežnika in geslo za root prikažeta v e-pošti ali na nadzorni plošči. Z lokalnega računalnika se povežite tako:
ssh root@1.2.3.4
Če vam je ponudnik namesto gesla dal ključ SSH, se povežite z -i path/to/key. Od tu naprej predpostavljam, da uporabljate svežo namestitev Ubuntu 22.04 ali 24.04 LTS.
2. korak. Zaženite ukaz za namestitev Coolifyja.
En ukaz iz uradne dokumentacije:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
Skript opravi tri stvari:
- Preveri sistem (Ubuntu LTS? root? AMD64?)
- Namesti Docker in Docker Compose, če še nista nameščena
- Prenese slike Coolifyja (
coolify/coolify,coolify/realtime,traefik) in jih zažene v ozadju prek docker-compose
To traja 3–5 minut. Videli boste izpisovanje dnevnikov apt-get, nato docker pull. Ko se prikaže Coolify v4.1.0 is now running, pojdite na 3. korak.
3. korak. Odprite spletni vmesnik.
V brskalniku odprite:
http://1.2.3.4:8000
Coolify prikaže čarovnika za nastavitev — obrazec za ustvarjanje prvega uporabnika. Vnesite e-poštni naslov in geslo ter ju shranite. Ta uporabnik samodejno postane skrbnik; drugih uporabnikov še ne potrebujete.
Po shranjevanju se prikaže prazna nadzorna plošča: na levi je stranska vrstica z možnostmi Resources / Projects / Servers / Sources / Notifications / Settings, na sredini pa poziv »Add your first resource.«
4. korak. Odprite vrata v požarnem zidu ponudnika (ne v UFW).
Coolify že deluje, vendar je od zunaj dostopen samo prek vrat 8000 (nadzorna plošča). Če želite uporabnikom omogočiti dostop do aplikacij, morate odpreti vrata 80 (HTTP) in 443 (HTTPS):
| Vrata | Namen |
|---|---|
| 22 | Dostop do strežnika prek SSH |
| 80 | Sprejema promet HTTP, potreben za preverjanje Let's Encrypt |
| 443 | Sprejema promet HTTPS za uporabnike |
| 8000 | Nadzorna plošča Coolify (po nastavitvi domene po meri za nadzorno ploščo bomo ta vrata zaprli) |
Pomembna past, navedena v uradni dokumentaciji:
Docker uporablja pravila iptables, ki temeljijo na NAT-u, in lahko zaobide tradicionalne požarne zidove Linuxa, kot je UFW.
To pomeni, da bo Docker prek iptables še vedno izpostavil vsebnike, tudi če vklopite UFW in zaprete vsa vrata. UFW je tu neuporaben. Rešitev je, da vrata odpirate in zapirate na nadzorni plošči ponudnika, ne prek UFW. Pri Timewebu / Selectelu / Aezi to storite v razdelku »Network → Firewall« v spletni konzoli.
5. korak (neobvezno). Povežite nadzorno ploščo s svojo domeno.
Če želite obiskati https://coolify.example.com namesto http://1.2.3.4:8000, ustvarite zapis DNS A coolify.example.com → 1.2.3.4, v Coolifyju odprite Settings → Instance Settings → Instance Domain, vnesite poddomeno in shranite. Coolify bo zahteval potrdilo Let's Encrypt, nato pa čez minuto znova naložil nadzorno ploščo prek HTTPS.
Nato lahko v požarnem zidu zaprete vrata 8000 — nadzorna plošča bo dostopna prek HTTPS na standardnih vratih 443.
Kako povezati GitHub: App ali PAT?
Ključna ugotovitev
Coolify podpira dva načina povezave z GitHubom: GitHub App (priporočeno) in Personal Access Token (PAT). Uporabite GitHub App: nastavitev s čarovnikom traja 5 minut, predogledi PR delujejo, dovoljenja pa je mogoče natančno omejiti na raven repozitorija. PAT je zastarela možnost za stare primere; ne omogoča uvedb za predogled in predstavlja tveganje globalnega dostopa do vseh vaših repozitorijev. Uradna dokumentacija neposredno pravi: »za 95% uporabnikov je GitHub App prava izbira.«
V Coolifyju pojdite na Sources → + Add → GitHub App. Coolify prikaže čarovnika s tremi zasloni:
- Ime in opis — poimenujte vir (vnesite
github-main) in po želji dodajte opis. - Configure on GitHub — gumb vas odpelje na GitHub.com in samodejno odpre obrazec za ustvarjanje aplikacije GitHub z ustreznimi dovoljenji.
- Confirm — po vrnitvi z GitHuba kliknite »Save.«
V drugem koraku vas bo GitHub prosil, da potrdite dovoljenja, ki jih zahteva Coolify:
| Dovoljenje | Raven | Namen |
|---|---|---|
| Contents | Samo za branje | Kloniranje repozitorija |
| Pull Requests | Branje in pisanje | Ustvarjanje uvedb predogleda in komentiranje PR-jev |
| Email addresses | Samo za branje | Prepoznavanje commitov |
| Metadata | Samo za branje | Prikaz seznama repozitorijev |
To so minimalna dovoljenja — GitHub App ne more videti vaših zasebnih ključev, ne more pisati v main in ne more dostopati do repozitorijev, ki jih niste izrecno povezali.
Iz uradne dokumentacije:
Personal Access Token (PAT) je stara metoda; odsvetujem njegovo uporabo. Slabosti:
- PAT omogoča globalni dostop do vseh vaših repozitorijev (tudi zasebnih)
- Predogledi PR ne delujejo — ta funkcija je na voljo samo v GitHub App
- Žeton velja dolgo (90 dni, leto dni ali nedoločen čas) — če uide, je to slabo
PAT uporabite le, če delate z repozitorijem organizacije, katere varnostna politika prepoveduje GitHub Apps, in se temu ne morete izogniti.
Po shranjevanju vira v Coolifyju boste na nadzorni plošči videli GitHub App s seznamom povezanih repozitorijev. Ko ustvarite novo aplikacijo, boste lahko katerega koli izbrali z enim klikom.
Kako v 6 korakih uvesti projekt Next.js iz Claude Code
Ključna ugotovitev
Celotna pot od prazne nastavitve Claude Code do delujoče spletne strani: 1) v prazni mapi zaženite claude, opišite projekt in Claude bo ustvaril kodo; 2) zaženite git init && git remote add (Claude lahko to opravi sam z ukazom slash); 3) potisnite spremembe v GitHub; 4) v Coolifyju izberite »+ New Resource → Application« in izberite repozitorij; 5) dodajte spremenljivke okolja; 6) Deploy. Coolify bo zaznal, da gre za Next.js, izbral gradbeni paket Nixpacks, v 3–5 minutah zgradil sliko Docker in ponudil začasno domeno v obliki xxx, ki ima HTTPS že nastavljen.
1. korak. Claude Code v prazni mapi opišite projekt.
mkdir my-vibe-app
cd my-vibe-app
git init
claude
V seji:
Zgradi projekt Next.js 14 app router:
- domača stran s seznamom uporabnikov
- končna točka /api/users vrne polje iz podatkovne zbirke
- Postgres prek Prisma
- Tailwind za sloge
- .env.example z DATABASE_URL
- README.md z navodili za zagon projekta
Claude bo ustvaril strukturo datotek, package.json, prisma/schema.prisma in .env.example. Prosite ga tudi:
Ustvari Dockerfile za produkcijske gradnje in .dockerignore.
To ni obvezno — Coolify bo gradil z Nixpacks tudi brez Dockerfila. Toda Dockerfile vam omogoča nadzor nad postopkom, pri večjih projektih pa je hitrejši.
2. korak. Ustvarite repozitorij GitHub in vanj potisnite spremembe.
To lahko naredite ročno prek uporabniškega vmesnika GitHub + git remote add origin ..., lahko pa to namesto vas opravi Claude Code:
/commit-push-pr Initial Next.js app generated with Claude Code
Ali preprosto recite: »Zapiši vse spremembe in jih potisni v nov repozitorij my-vibe-app v mojem računu.« Claude bo uporabil CLI gh za ustvarjanje zasebnega (ali javnega) repozitorija in izvedel prvi push. Vir: uradni ukaz Claude Code.
3. korak. V Coolifyju ustvarite Application.
Na nadzorni plošči Coolify kliknite + New → Application. Odpre se obrazec:
- Source — izberite
github-main(GitHub App, ki ste ga povezali v prejšnjem razdelku H2) - Repository — na seznamu izberite
my-vibe-app - Branch —
main - Build Pack — Coolify ga bo samodejno zaznal. Če obstaja Dockerfile, bo uporabil
dockerfile. Sicer bo uporabilnixpacks. Izbiro lahko ročno spremenite. - Domain — za zdaj pustite predlagano vrednost (
xxx); je začasna in jo boste pozneje zamenjali s svojo - Port — za Next.js je privzeta vrednost
3000
Shranite.
4. korak. Dodajte spremenljivke okolja.
V ustvarjeni aplikaciji odprite zavihek Environment Variables. Spremenljivke dodajajte eno po eno:
DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...
Če nimate podatkovne baze, jo ustvarite neposredno v Coolifyju: + New → Database → PostgreSQL. Coolify bo v 30 sekundah zagnal vsebnik Postgres in posredoval interni DATABASE_URL v obliki postgresql://postgres:pass@postgres-xyz:5432/postgres — vnesite ga v aplikacijo.
Vse spremenljivke so šifrirane v podatkovni bazi Coolify in niso prikazane v dnevnikih gradnje.
5. korak. Kliknite Deploy.
V zgornjem desnem kotu je moder gumb Deploy. Živi dnevniki se bodo prikazali na zavihku Logs:
[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
[stage: ssl] Let's Encrypt cert issued for xxx
Prva gradnja traja 3–5 minut (prenese osnovno sliko Node in namesti odvisnosti). Naslednje gradnje zaradi predpomnjenja slojev Docker trajajo 60–90 sekund.
Ko se stanje spremeni v Running, kopirajte URL aplikacije iz Coolifyjevega polja Domains in v brskalniku odprite točen naslov. To vrednost spodaj uporabite kot <app-url-from-coolify>; oznaka v kotnih oklepajih je nadomestilo, ne pravi naslov. Prikazati bi se morala domača stran s HTTPS, ki deluje takoj. Brezplačna storitev DNS z nadomestnim znakom razreši katero koli poddomeno z naslovom IP (1-2-3-4 → 1.2.3.4). Coolify jo uporablja za začasne domene, da lahko stran odprete takoj, ne da bi nastavili svoj DNS.
6. korak. Preverite, ali vse deluje.
Odprite URL aplikacije iz prejšnjega koraka z dodano potjo /api/users, na primer <app-url-from-coolify>/api/users, brez podvajanja poševnice. To je končna točka JSON iz 1. koraka; korenski URL aplikacije je domača stran. Če se pojavi napaka 500, boste sled sklada videli na zavihku Logs. Najpogostejša težava pri prvi uvedbi je, da DATABASE_URL kaže na neobstoječo podatkovno bazo. Odpravite jo tako, da v Coolifyju ustvarite instanco PostgreSQL (glejte zgornji 4. korak) in zamenjate DATABASE_URL.
15 minut od trenutka, ko naročite VPS. V izvirnem primeru je ta potek na svežem strežniku trajal 12–18 minut.
Kako nastaviti domeno po meri in HTTPS
Ključna ugotovitev
Domeno po meri povežete v 3 korakih: ustvarite zapis DNS A, ki kaže na IP strežnika, v konfiguracijo Coolifyja vnesete svojo domeno namesto začasne domene, omogočite Automatic HTTPS in kliknete Redeploy. Let's Encrypt bo potrdilo SSL samodejno izdal 2–3 minute po razširitvi zapisa DNS (običajno traja 5–30 minut). Ključno je, da se DNS razreši, preden kliknete Redeploy; sicer preverjanje Let's Encrypt ne bo uspelo in pred naslednjim poskusom boste morali čakati 12 minut.
1. korak. Na nadzorni plošči registrarja ustvarite zapis DNS A.
Izvirni primeri uporabljajo domene, gostovane pri Reg.ru, Beget ali Timeweb. Postopek je enak:
| Vrsta zapisa | Ime | Vrednost |
|---|---|---|
| A | app (ali @ za korensko domeno) | 1.2.3.4 (IP strežnika) |
Shranite zapis, odprite konzolo in preverite:
dig app.example.com +short
# Vrnil bi moral 1.2.3.4
Če se ne vrne nič ali pa se vrne drug IP, se DNS še ni razširil. Počakajte 5–30 minut.
2. korak. Vnesite svojo domeno v Coolify.
V aplikaciji odprite zavihek Configuration → General. V polju Domains začasni URL aplikacije, kopiran iz Coolifyja, zamenjajte z https://app.example.com (z uporabo svoje nastavljene domene). Omogočite Automatic HTTPS (običajno je privzeto že omogočen).
Shranite in kliknite Redeploy.
3. korak. Počakajte na potrdilo Let's Encrypt.
Dnevniki gradnje bodo prikazali:
[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
Čez 2–3 minute bo vaša stran na voljo na naslovu https://app.example.com z zeleno ključavnico v naslovni vrstici.
Kaj gre lahko narobe z Let's Encrypt (3 najpogostejše težave iz uradnega vodnika za odpravljanje težav):
- Vrata 80 so zaprta v požarnem zidu. Let's Encrypt preverja domeno s preizkusom HTTP — pošlje zahtevo na
http://app.example.com/.well-known/acme-challenge/xxx. Brez vrat 80 preverjanje ne bo uspelo. Odprite jih v požarnem zidu ponudnika. - Proxy Cloudflare je omogočen (oranžen oblak). Prestrezal bo zahtevo Let's Encrypt in vrnil svojo nadomestno stran — preverjanje bo spodletelo. Rešitev je preklop na »DNS only« (siv oblak) ali nastavitev preizkusa DNS-01 prek API-ja Cloudflare.
- DNS se še ni razširil. Če ste zapis A ustvarili pred 30 sekundami in takoj kliknili Redeploy, Let's Encrypt ne bo videl vaše domene. Počakajte 5–30 minut, da se DNS razširi po strežnikih.
Omejitev hitrosti Let's Encrypt: 5 neuspelih poskusov na uro za eno domeno, nato je mogoče poskusiti znova v korakih po 12 minut. Če dosežete omejitev, ne kliknite Redeploy 10-krat zapored; preverite dnevnike, odpravite težavo in poskusite znova čez 12 minut.
Kako Claude Code upravlja Coolify prek MCP?
Ključna ugotovitev
Claude Code prek Model Context Protocol dobi neposreden dostop do API-ja Coolify — rečete lahko »uvedi to aplikacijo« in s tem začnete gradnjo, preverite stanje, preberete dnevnike ali posodobite spremenljivke okolja. Na voljo so tri možnosti: forsonny/Coolify-MCP-Server (osnovna, 7 kategorij opravil), dazeb/coolify-mcp-enhanced (15+ dodatnih orodij in uvedba podatkovne baze z enim klikom) ter ajmcclary/Coolify-Manager (Claude Skill, zasnovan okoli uradnega CLI-ja). Od različice v4.1.0 (18. maja 2026) Coolify ponuja izvorno končno točko MCP brez strežnikov tretjih oseb — za zdaj pa samo za branje.
Model Context Protocol (MCP) je standard podjetja Anthropic, ki Claude Code omogoča komunikacijo z zunanjimi sistemi (za več informacij glejte vodnik po strežnikih MCP). Povežite strežnik MCP in Claude dobi zbirko orodij, ki jih lahko pokliče. Za Coolify so na voljo trije pripravljeni strežniki in ena izvorna možnost.
Možnost 1. forsonny/Coolify-MCP-Server-for-Claude-Code — osnovna.
Kaj zmore:
- Aplikacije: ustvarjanje, zagon, zaustavitev, ponovni zagon
- Storitve: izpis, ustvarjanje, zagon/zaustavitev/ponovni zagon
- Uvedbe: ogled delujočih, pridobivanje po UUID-ju
- Ekipe in člani: izpis, pridobivanje informacij
- Ključi SSH: izpis, ustvarjanje
- Spremenljivke okolja: celoten CRUD za aplikacije in storitve
- Vpogledi v strežnik: domene na strežnik, stanje, različica
Namestitev:
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
Nato lahko v Claude Code napišete:
Prikaži stanje aplikacije my-vibe-app v Coolify in 3 najnovejše uvedbe.
Claude bo vrnil tabelo.
Možnost 2. dazeb/coolify-mcp-enhanced — razširjena (priporočeno).
Kaj dodaja osnovnemu naboru:
- Uvedba PostgreSQL / Redis / MinIO z enim klikom prek UI-ja — recite »nastavi Postgres zame« in ustvaril bo vsebnik ter vrnil DATABASE_URL
- Spremljanje v realnem času + poraba virov — CPU/RAM za vsako aplikacijo v realnem času
- Množične posodobitve konfiguracije env — z enim ukazom posodobite 20 spremenljivk
- Podpora za Docker Compose — uvedba večstoritvenih aplikacij
Konfiguracija za Claude Code (.mcp.json v korenski mapi projekta):
{
"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 — Claude Skill, zgrajen okoli CLI-ja.
To ni strežnik MCP, temveč Claude Code Skill, ki ovije uradni CLI Coolify. Vključuje:
- Diagnostiko stanja storitev in vsebnikov
- Diagnostiko potrdil SSL
- Podporo za več instanc (če imate več strežnikov Coolify)
- Recepti za odpravljanje težav
Namestitev: prenesite skill in ga namestite v ~/.claude/skills/coolify-manager/. Claude Code ga bo zaznal in ponudil za ustrezna opravila.
Možnost 4 (novo maja 2026). Izvorni MCP v Coolify v4.1.0.
Dnevnik sprememb za v4.1.0 z dne 18. maja 2026 navaja:
Dodana je podpora za MCP na ravni instance z orodji za branje virov Coolify in API/UI.
Coolify zdaj ponuja lastno končno točko MCP — Claude Code lahko povežete neposredno, brez strežnikov tretjih oseb. Za zdaj omogoča samo branje (seznami aplikacij, stanja, konfiguracije), brez operacij spreminjanja. A to zadostuje za večino opravil, kot je »povej mi o infrastrukturi.«
Povežite ga prek .mcp.json:
{
"mcpServers": {
"coolify-native": {
"url": "https://coolify.example.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
Počakajte na poln dostop za pisanje v izvornem MCP v različici v4.2 ali v4.3 — ekipa Coolify ga je obljubila do konca leta 2026.
5 pasti pri prvi uvedbi — in kako se jim izogniti
Ključna ugotovitev
Najpogostejše napake pri prvi uvedbi so premalo RAM-a, zaprta vrata 80, proxy Cloudflare, ki pokvari Let's Encrypt, neučinkovita zaščita Dockerja z UFW in izbira PAT namesto GitHub App. Vse je opisano v uradni dokumentaciji, a brez praktičnih izkušenj se hitro ujamete v te pasti. Spodaj je kontrolni seznam s 5 točkami, ki temelji na prvotni izkušnji s prvo namestitvijo Coolifyja.
Past 1: manj kot 2 GB RAM-a — namestitev se zaradi OOM ne uspe.
Simptom: curl install.sh pride do docker pull coolify/coolify, obstane pri 70 %, nato pa se postopek prekine z Killed (signal 9). Dnevniki dmesg | tail prikažejo Out of memory: Killed process.
Rešitev:
# Create a 4 GB swap file to solve the problem temporarily
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
Dolgoročno nadgradite na 4 GB RAM-a. Coolify deluje s swapom, vendar lahko gradnje večjih projektov Next.js spodletijo.
Past 2: UFW je omogočen, vendar Docker še vedno odpira vrata.
Simptom: omogočili ste UFW in zaprli vsa vrata razen 22, vendar je vaša aplikacija še vedno dostopna z interneta prek nekih naključnih vrat (na primer 3000).
Razlog po uradni dokumentaciji:
Coolify deluje v Dockerju, ki uporablja pravila iptables na podlagi NAT-a in lahko zaobide tradicionalne požarne zidove Linuxa, kot je UFW.
Rešitev: uporabite požarni zid na nadzorni plošči ponudnika, ne UFW. Timeweb / Selectel / Aeza imajo razdelek »Firewall« ali »Network → Firewall«, kjer pravila nastavite na ravni navideznega omrežja — delujejo, še preden paketi dosežejo Docker.
Druga možnost je ufw-docker, skript, ki popravi UFW za združljivost z Dockerjem. Vendar je to bolj zapleteno kot klikanje po nadzorni plošči.
Past 3: proxy Cloudflare (oranžen oblak) pokvari Let's Encrypt.
Simptom: po Redeploy dnevniki prikažejo Let's Encrypt validation failed - challenge returned 403.
Razlog: Cloudflare posreduje zahtevo HTTP storitve Let's Encrypt in vrne svojo stran namesto vaše datoteke preizkusa.
Rešitev — izberite eno od dveh možnosti:
- Preklopite na »DNS only« (sivi oblak v Cloudflareju). Slabost: izgubite CDN in zaščito Cloudflare.
- Nastavite preizkus DNS-01 prek API-ja Cloudflare. V Coolifyju pojdite v Settings → SSL Configuration, izberite ponudnika Cloudflare in vnesite žeton API z dovoljenji Zone:Read in DNS:Edit. Let's Encrypt bo preverjanje opravil prek zapisa TXT namesto HTTP-ja.
Druga možnost je zahtevnejša za nastavitev, vendar ohrani proxy Cloudflare.
Past 4: PAT namesto GitHub App — predogledi PR ne delujejo.
Simptom: GitHub ste povezali z Personal Access Tokenom; vse deluje, vendar se predogledi uvedb ne ustvarjajo za PR-je. V GitHubu ste odprli PR, v Coolifyju pa se ni pojavilo nič.
Razlog: predogledi PR so ekskluzivna funkcija GitHub App. PAT prek webhooka ne prejema dogodkov pull_request.
Rešitev: znova povežite GitHub prek aplikacije. Sources → Add → GitHub App → dokončajte čarovnika. Stari vir PAT lahko izbrišete.
Past 5: »Coolify == Vercel« ne drži povsem.
Česa Coolify ne naredi že ob namestitvi:
| Vercel | Coolify | Kaj storiti |
|---|---|---|
| Globalni CDN | Ne | Postavite Cloudflare pred njega (brezplačno za statično vsebino) |
| Inkrementalna statična regeneracija | Ne | revalidatePath deluje samo na vašem strežniku |
| Optimizacija slik | Ne | Uporabite next/image z lokalnim nalagalnikom ali Cloudflare Images |
| Samodejno prilagajanje ob prometnih konicah | Ne | Zmogljivost prilagodite ročno; nadgradite VPS |
| Edge Functions | Ne | Uporabite običajne poti API |
Če je vaš projekt visokoprometni SaaS z globalnim občinstvom in zahtevo po zakasnitvi < 100 ms po vsem svetu, Coolify ni primerna izbira; izberite Vercel Enterprise. Če ste ustvarjalec z vibe codingom in preizkušate MVP s 100–1,000 uporabniki na dan, Coolify pokrije vse vaše potrebe.
Iz iskrene analize samostojnega gostovanja:
15 minut v naslovu tega vodnika se nanaša na najbolj tekoč potek pri prvi uvedbi enega projekta. Popolna nastavitev infrastrukture s spremljanjem, varnostnimi kopijami in opozorili traja večer ali dva. Bodite iskreni do sebe.
Koliko boste v enem letu prihranili v primerjavi z Vercelom?
Ključna ugotovitev
Obstaja »skriti časovni davek«: 5–10 ur za začetno nastavitev in 1–2 uri na mesec za vzdrževanje.
Spodnji zneski Vercel so ocene scenarijev iz maja 2026, ne trenutne ponudbe. Predstavljajo samo eno stran primerjave. Samostojno gostovani Coolify nima licenčnine, VPS, varnostne kopije, shramba, promet in vzdrževanje pa še vedno stanejo. Pridobite ponudbo, ki izpolnjuje zgornje zahteve; v teh scenarijih številčna cena VPS ni podana, zato stalnega prihranka ni mogoče utemeljiti.
Naj bo C celotni mesečni račun za izbrani VPS, shrambo varnostnih kopij, dodatni promet, spremljanje in morebitno plačljivo nadzorno ploščo. Vsak strošek vključite enkrat. Naj bo r vaša urna cena vzdrževanja, pri čemer povsod uporabite isto valuto. Članek ocenjuje 5–10 začetnih ur in 1–2 uri mesečno: 17–34 ur v prvem letu ter 12–24 ur v naslednjih letih.
| Scenarij | Ocena Vercel/mesec | Vercel/leto | Infrastruktura Coolify/mesec | Celotni strošek Coolify prvo leto z delom | Prihranek prvo leto glede na Vercel |
|---|---|---|---|---|---|
| En prototip, 100,000 obiskov/mesec | $20 osnova + ~$5 promet = $25 | $300 | C | 12C + (17–34)r | $300 − 12C − (17–34)r |
| Pet projektov na enem VPS | $20 osnova + $30 promet/funkcije = $50 | $600 | C | 12C + (17–34)r | $600 − 12C − (17–34)r |
| Trije razvijalci, pet projektov | $60 sedeži + $30 promet = $90 | $1,080 | C | 12C + (17–34)r | $1,080 − 12C − (17–34)r |
Če obremenitve zahtevajo različno velike strežnike, za vsak scenarij uporabite ločen C. Za mesečno primerjavo začetni čas nastavitve razporedite na 12 mesecev: mesečni ekvivalent prvega leta je C + (17–34)r/12. Celotni strošek naslednjih let je 12C + (12–24)r. Formule primerjajo navedeno oceno Vercel s stroški lastnega gostovanja; tudi na strani Vercel vključite primerljivo delo vzdrževanja. Negativen prihranek pomeni, da je lastno gostovanje pri vaših vhodnih podatkih dražje. Če r že vključuje inženirjevo plačo, je ne prištejte še enkrat v celoti.
Pred prehodom C izpolnite z resnično ponudbo ponudnika in načrtom varnostnih kopij, izberite r ter primerjajte dejansko mesečno porabo. Brez teh podatkov članek podaja model stroškov, ne trditve o dolarskem prihranku.
Glavna prednost ni denar. Ko preidete na Coolify, izgine kategorija »odvisnost od plačilnih pravil nekoga drugega«. Virtualne posredniške kartice z 20-odstotno provizijo niso več potrebne.
Coolify ni cenejši Vercel. Gre za drugo kategorijo izdelka: infrastruktura je vaša, zanjo prevzamete odgovornost, denar pa prihranite tako, da sprejmete njeno zapletenost.
Če je uvedba prototipa vaša prva naloga po ustvarjanju projekta v Claude Code, je upravljanje okolja (env, skrivnosti, načrtovana opravila, varnostne kopije) del kontekstnega inženiringa. Brez strukture, ki določa, »kje je kaj«, se Claude izgubi, vi pa izgubljate čas ob vsaki spremembi. Celotna nastavitev vključuje: klon AI (Skills in Subagents, prilagojena vaši metodologiji) + druge možgane (projektno bazo znanja) + kontekstni inženiring (Plan Mode, /compact, okolje izvajanja). To so 3 stebri, brez katerih AI halucinira.
Viri
Celoten potek dela s kontekstom: klon AI + drugi možgani + kontekstni inženiring.
Več gradiva je na voljo na Ailoot.
Več podrobnosti
Vprašanja in odgovori: Coolify in Claude Code: Uvedite projekt na svoj VPS
Kateri URL mora po uvedbi vrniti JSON?
Kopirajte URL aplikacije iz Coolifyjevega polja Domains in odprite njegovo pot /api/users. Korenski URL je domača stran; /api/users je končna točka JSON, določena v vzorčnem projektu.
Kako izračunam, ali lastno gostovanje prihrani denar?
V C seštejte mesečne stroške VPS, varnostnih kopij, shrambe, prometa, spremljanja in izbirne nadzorne plošče. Celotni strošek prvega leta je 12C in 17–34 ur po vaši urni ceni; primerjajte ga z letno oceno Vercel scenarija in na obeh straneh vključite primerljivo vzdrževanje.