Coolify ja Claude Code: Ota projekti käyttöön omalla VPS-palvelimellasi

Alustan rajoitukset ja maksuehdot vuonna 2026#

Tyypillinen vibe-koodaajan tilanne vuonna 2026: rakennat MVP:n Cursorissa tai Claude Codessa illan aikana, siirrät sen GitHub-repositorioon, avaat vercel.com → yhdistät repositorion → päädyt tilausnäyttöön → syötät korttisi → saat ilmoituksen Transaction declined.

Tämä ei ole virhe tai tilapäinen käyttökatko.

Railway, Render, Heroku — sama tarina. Heroku sulki todella ilmaistasonsa kaikilta vuonna 2022, ja helmikuussa 2026 projekti siirtyi ylläpitotilaan — uusia ominaisuuksia tai uusia Enterprise-sopimuksia ei tule. Käyttäjälle, jonka korttia ei tueta, tämä tarkoittaa: ”ovi on kiinni; kierrä välikäden kautta, joka veloittaa 20 %:n palkkion.”

Voit maksaa Kazakstanin virtuaalisilla Visa-korteilla tai yritysten maksupalveluilla. Se tarkoittaa kuitenkin +20 % hintaan, +30 minuuttia jokaiseen maksuun ja riskiä, että tilisi suljetaan, kun maksunvälittäjä havaitsee maantieteellisen ristiriidan.

Alkuperäinen esimerkki sisälsi kolme yritystä — Vercel Prossa, Railwaylla ja Renderissä.

Mikä Coolify on ja miten itsehostattu alusta toimii?#

Coolify on Laravelilla + Dockerilla rakennettu avoimen lähdekoodin projekti, joka muuttaa tyhjän VPS-palvelimen sovellusten käyttöönottopalveluksi. Asenna Coolify kerran, minkä jälkeen hoidat kaiken muun verkkokäyttöliittymässä: yhdistät GitHubin, valitset repositorion ja napsautat Deploy.

Virallinen dokumentaatio tiivistää asian osuvasti:

Kulissien takana Coolify koostuu neljästä osasta:

1. Laravel 12 + Livewire 3 + Tailwind v4 -tekniikoilla rakennettu verkkokäyttöliittymä — hallintapaneeli sovellustesi hallintaan.
2. Docker + Docker Compose — jokainen sovellus toimii omassa, muista eristetyssä kontissaan.
3. Käänteinen välityspalvelin (Traefik tai Caddy) — vastaanottaa saapuvan HTTP/HTTPS-liikenteen ja reitittää sen kontteihin.
4. Let's Encrypt -integraatio — myöntää ja uusii automaattisesti SSL-varmenteet kaikille verkkotunnuksille.

Tärkeimmät ominaisuudet, joiden ansiosta Coolify vastaa toiminnoiltaan Verceliä:

Globaali CDN on ainoa asia, jota Coolify ei sisällä vakiona. Tämä on rehellinen vastaus. Jos projektillasi on maailmanlaajuinen yleisö ja haluat pienentää viivettä Yhdysvalloissa ja Euroopassa oleville käyttäjille, aseta Cloudflare eteen; se on ilmainen staattiselle sisällölle.

Hinta: itsehostattu versio on ikuisesti ilmainen, eikä sovellusten, palvelinten tai käyttöönottojen määrää ole rajoitettu. Coolify Cloud on saatavilla hintaan $5/kuukausi kahdelle palvelimelle + $3 jokaisesta lisäpalvelimesta — palvelimet ovat silti sinun; Coolify Cloud ainoastaan ylläpitää hallintapaneelia.

Uusin julkaisu on v4.1.0, julkaistu May 18, 2026. Uusiin ominaisuuksiin kuuluvat beetavaiheessa oleva Railpack-koontipaketti, auditointiloki, käyttöönottojen väliset määrityserot sekä natiivi MCP-päätepiste (vain luku). Lähde: GitHub-julkaisut.

Minkä VPS-palvelimen Coolifylle kannattaa hankkia vuonna 2026?#

Coolifyn vähimmäisvaatimukset ovat suoraan peräisin virallisesta dokumentaatiosta:

Vähimmäismäärä — 2 GB RAM-muistia — on ehdoton alaraja. 1 GB:n muistilla asennusohjelma etenee Dockeriin asti, törmää muistin loppumiseen (OOM) ja jumiutuu. Älä säästä RAM-muistissa.

Hintalähteet: Timeweb Cloud, FirstVDS ja Selectel.

Jos tarvitset enemmän tehoa (100 GB:n tietokanta, useita Postgres-instansseja), hanki Aeza Dedicated.

ÄLÄ hanki näitä:

• Jaettu VPS, jossa on 512 MB–1 GB RAM-muistia — ei riitä edes Coolifylle. Se on tarkoitettu nginxissä toimiville staattisille sivustoille, ei PaaS-alustalle.

Haluatko käyttöönoton lisäksi rakentaa kokoonpanon, joka tekee Claudesta luotettavan? Coolify on suoritusympäristö, mutta ilman jäsenneltyä kontekstia (CLAUDE.md, toiset aivot ja konteksti-insinöörityö) Claude hallusinoi edelleen pitkissä tehtävissä. Kattava kokoonpano sisältää kaikki kolme: AI-klooni + Second Brain + Context Engineering — tämän yhdistelmän ansiosta Claude muuttuu ”hallusinoivasta avustajasta” luotettavaksi työkaluksi.

Näin asennat Coolifyn 5 minuutissa#

Vaihe 1. Yhdistä VPS-palvelimeen SSH:lla.

Kun olet luonut VPS-palvelimen palveluntarjoajalta, palvelimen IP-osoite ja root-salasana näkyvät sähköpostissa tai hallintapaneelissa. Yhdistä paikalliselta koneeltasi:

ssh root@1.2.3.4

Jos palveluntarjoaja antoi salasanan sijasta SSH-avaimen, yhdistä komennolla -i path/to/key. Oletan tästä eteenpäin, että käytössäsi on puhdas Ubuntu 22.04- tai 24.04 LTS -asennus.

Vaihe 2. Suorita Coolifyn asennuskomento.

Yksi komento virallisesta dokumentaatiosta:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

Skripti tekee kolme asiaa:

1. Tarkistaa järjestelmän (Ubuntu LTS? root? AMD64?)
2. Asentaa Dockerin ja Docker Composen, jos niitä ei ole vielä asennettu
3. Lataa Coolify-levykuvat (coolify/coolify, coolify/realtime, traefik) ja suorittaa ne taustalla docker-composen kautta

Tämä kestää 3–5 minuuttia. Näet apt-get-lokien vierivän ohi ja niiden jälkeen docker pull -komennon. Kun näet ilmoituksen Coolify v4.1.0 is now running, siirry vaiheeseen 3.

Vaihe 3. Avaa verkkokäyttöliittymä.

Avaa tämä selaimessa:

http://1.2.3.4:8000

Coolify näyttää asennusvelhon — lomakkeen ensimmäisen käyttäjän luomiseen. Anna sähköpostiosoite ja salasana ja tallenna ne. Käyttäjästä tulee automaattisesti ylläpitäjä; et tarvitse vielä muita käyttäjiä.

Tallennuksen jälkeen päädyt tyhjään hallintapaneeliin: vasemmalla on sivupalkki, jossa ovat Resources / Projects / Servers / Sources / Notifications / Settings, ja keskellä kehotus ”Add your first resource”.

Vaihe 4. Avaa portit palveluntarjoajan palomuurissa (ei UFW:ssä).

Coolify on jo käynnissä, mutta ulkoa on käytettävissä vain portti 8000 (hallintapaneeli). Jotta käyttäjät pääsevät sovelluksiisi, sinun on avattava portit 80 (HTTP) ja 443 (HTTPS):

Tärkeä sudenkuoppa virallisesta dokumentaatiosta:

Tämä tarkoittaa, että vaikka ottaisit UFW:n käyttöön ja sulkisit kaikki portit, Docker tuo konttinsa silti saataville iptablesin kautta. UFW on tässä hyödytön. Ratkaisu on avata ja sulkea portit palveluntarjoajan hallintapaneelissa, ei UFW:ssä. Timewebissä / Selectelissä / Aezassa tämä tehdään verkkokonsolin kohdassa ”Network → Firewall”.

Vaihe 5 (valinnainen). Liitä hallintapaneeli verkkotunnukseesi.

Jos haluat siirtyä osoitteeseen https://coolify.example.com osoitteen http://1.2.3.4:8000 sijasta, luo DNS A -tietue coolify.example.com → 1.2.3.4, siirry Coolifyssa kohtaan Settings → Instance Settings → Instance Domain, syötä aliverkkotunnuksesi ja tallenna. Coolify pyytää Let's Encrypt -varmenteen ja lataa hallintapaneelin uudelleen HTTPS-yhteydellä minuutin kuluttua.

Sen jälkeen voit sulkea portin 8000 palomuurista — hallintapaneeli on käytettävissä HTTPS-yhteydellä oletusportissa 443.

Näin yhdistät GitHubin: App vai PAT?#

Siirry Coolifyssa kohtaan Sources → + Add → GitHub App. Coolify näyttää kolmivaiheisen ohjatun toiminnon:

1. Nimi ja kuvaus — nimeä lähde (kirjoita github-main) ja lisää halutessasi kuvaus.
2. Määritä GitHubissa — painike vie sinut GitHub.comiin ja avaa automaattisesti GitHub Appin luontilomakkeen oikeilla käyttöoikeuksilla.
3. Vahvista — palattuasi GitHubista napsauta ”Save”.

Toisessa vaiheessa GitHub pyytää vahvistamaan Coolifyn vaatimat käyttöoikeudet:

Nämä ovat vähimmäiskäyttöoikeudet — GitHub App ei näe yksityisiä avaimiasi, voi kirjoittaa main-haaraan tai käyttää repositorioita, joita et ole erikseen yhdistänyt.

Virallisesta dokumentaatiosta:

Personal Access Token (PAT) on vanha menetelmä; en suosittele sen käyttöä. Haittoja:

• PAT antaa maailmanlaajuisen pääsyn kaikkiin repositorioihisi (myös yksityisiin)
• PR-esikatselut eivät toimi — ominaisuus on vain GitHub Appissa
• Tunnus on voimassa pitkään (90 päivää, vuoden tai toistaiseksi) — vuotaminen on vakava asia

Käytä PAT-tunnusta vain, jos työskentelet organisaation repositorion kanssa, jonka tietoturvakäytäntö kieltää GitHub Appit eikä kiertotietä ole.

Kun olet tallentanut lähteen Coolifyssa, näet hallintapaneelissa GitHub Appin ja luettelon yhdistetyistä repositorioista. Kun luot uuden sovelluksen, voit valita niistä minkä tahansa yhdellä napsautuksella.

Näin otat Claude Code -projektin Next.js:llä käyttöön kuudessa vaiheessa#

Vaihe 1. Kuvaile projektia Claude Codelle tyhjässä kansiossa.

mkdir my-vibe-app
cd my-vibe-app
git init
claude

Istunnossa:

Rakenna Next.js 14 -sovellusreitittimen projekti:
- etusivu, jolla on käyttäjäluettelo
- /api/users-päätepiste palauttaa tietokannasta taulukon
- Postgres Prismalla
- Tailwind tyyleihin
- .env.example, jossa on DATABASE_URL
- README.md, jossa on projektin suoritusohjeet

Claude luo tiedostorakenteen, package.jsonin, prisma/schema.prisman ja .env.examplen. Pyydä lisäksi:

Luo Dockerfile tuotantokoontiversioita varten ja .dockerignore.

Tämä on valinnaista — Coolify rakentaa Nixpacksilla myös ilman Dockerfilea. Dockerfile antaa kuitenkin hallinnan prosessiin ja nopeuttaa suurempien projektien rakentamista.

Vaihe 2. Luo GitHub-repositorio ja pushaa projekti siihen.

Voit tehdä tämän manuaalisesti GitHub-käyttöliittymässä + komennolla git remote add origin ..., mutta Claude Code voi tehdä sen puolestasi:

/commit-push-pr Initial Next.js app generated with Claude Code

Tai sano vain: ”Committoi kaikki ja pushaa ne uuteen repositorioon my-vibe-app tililleni.” Claude käyttää gh-CLI:tä yksityisen (tai julkisen) repositorion luomiseen ja ensimmäiseen pushiin. Lähde: Claude Code -virallinen komento.

Vaihe 3. Luo sovellus Coolifyssa.

Napsauta Coolifyn hallintapaneelissa + New → Application. Lomake avautuu:

1. Lähde — valitse github-main (edellisessä H2-osiossa yhdistämäsi GitHub App)
2. Repository — valitse luettelosta my-vibe-app
3. Branch — main
4. Build Pack — Coolify tunnistaa sen automaattisesti. Jos Dockerfile on olemassa, käytetään dockerfile-pakettia. Muussa tapauksessa käytetään nixpacks-pakettia. Voit ohittaa tämän asetuksen manuaalisesti.
5. Domain — jätä ehdotettu arvo toistaiseksi; se on väliaikainen, ja korvaat sen myöhemmin omallasi
6. Port — Next.js:n oletusarvo on 3000

Tallenna.

Vaihe 4. Lisää ympäristömuuttujat.

Avaa luomasi sovelluksen Environment Variables -välilehti. Lisää muuttujat yksi kerrallaan:

DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...

Jos sinulla ei ole tietokantaa, luo sellainen suoraan Coolifyssa: + New → Database → PostgreSQL. Coolify käynnistää Postgres-kontin 30 sekunnissa ja antaa sisäisen DATABASE_URL-osoitteen muodossa postgresql://postgres@postgres-xyz:5432/postgres — lisää se sovellukseesi.

Kaikki muuttujat salataan Coolify-tietokannassa, eikä niitä näytetä koontilokeissa.

Vaihe 5. Napsauta Deploy.

Oikeassa yläkulmassa on sininen Deploy-painike. Aktiiviset lokit näkyvät Logs-välilehdellä:

[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 temporary domain
[stage: ssl]     Let's Encrypt cert issued for temporary domain

Ensimmäinen koontiversio kestää 3–5 minuuttia (se hakee Node-peruslevykuvan ja asentaa riippuvuudet). Seuraavat koontiversiot valmistuvat 60–90 sekunnissa Docker-kerrosten välimuistin ansiosta.

Kun tilaksi vaihtuu Running, kopioi Coolifyn Domains-kentässä näkyvä sovelluksen URL ja avaa selaimessa täsmälleen se. Käytä tätä arvoa jäljempänä paikkamerkin <app-url-from-coolify> tilalla. Kulmasulkeinen nimi on paikkamerkki, ei todellinen osoite. Etusivun pitäisi näkyä HTTPS-yhteydellä. Verkkotunnuspalvelu selvittää IP-osoitteeseen perustuvan aliverkkotunnuksen. Coolify käyttää tätä väliaikaisissa verkkotunnuksissa, jotta voit avata sivuston heti määrittämättä omaa DNS:ää.

Vaihe 6. Tarkista, että kaikki toimii.

Avaa edellisen vaiheen sovellusosoite ja lisää sen perään /api/users, esimerkiksi <app-url-from-coolify>/api/users, ilman kaksinkertaista vinoviivaa. Tämä on vaiheessa 1 luotu JSON-päätepiste. Sovelluksen juuriosoite on etusivu. Jos saat 500-virheen, näet pinon jäljityksen Logs-välilehdellä. Ensimmäisen käyttöönoton yleisin ongelma on, että DATABASE_URL osoittaa olemattomaan tietokantaan. Korjaa ongelma luomalla PostgreSQL-instanssi Coolifyssa (katso vaihe 4 edellä) ja korvaamalla DATABASE_URL.

15 minuuttia VPS:n tilaushetkestä alkaen. Alkuperäisessä esimerkissä tämä työnkulku kesti 12–18 minuuttia puhtaalla palvelimella.

Näin määrität mukautetun verkkotunnuksen ja HTTPS:n#

Vaihe 1. Luo DNS A -tietue verkkotunnusrekisteröijäsi hallintapaneelissa.

Alkuperäisissä esimerkeissä käytetään Reg.ru:ssa, Begetissä tai Timewebissä ylläpidettyjä verkkotunnuksia. Toimintatapa on sama:

Tallenna tietue, avaa konsoli ja tarkista:

dig app.example.com +short
# Palautteen pitäisi olla 1.2.3.4

Jos tulosta ei tule tai IP-osoite on toinen, DNS ei ole vielä päivittynyt. Odota 5–30 minuuttia.

Vaihe 2. Syötä verkkotunnuksesi Coolifyyn.

Avaa sovelluksessa Configuration → General -välilehti. Korvaa Domains-kentässä Coolifysta kopioitu väliaikainen sovellusosoite osoitteella https://app.example.com käyttäen omaa määritettyä verkkotunnustasi. Ota Automatic HTTPS käyttöön (se on yleensä oletusarvoisesti käytössä).

Tallenna ja napsauta Redeploy.

Vaihe 3. Odota Let's Encrypt -varmennetta.

Koontilokeissa näkyy:

[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

2–3 minuutin kuluttua sivusto on käytettävissä osoitteessa https://app.example.com, ja osoiterivillä näkyy vihreä lukko.

Näin Let's Encryptissä voi ilmetä ongelmia (kolme yleisintä ongelmaa virallisen vianmääritysoppaan mukaan):

1. Portti 80 on suljettu palomuurissa. Let's Encrypt käyttää vahvistukseen HTTP-haastetta — se lähettää pyynnön osoitteeseen http://app.example.com/.well-known/acme-challenge/xxx. Vahvistus ei onnistu ilman porttia 80. Avaa portti palveluntarjoajan palomuurista.
2. Cloudflare-välityspalvelu on käytössä (oranssi pilvi). Se sieppaa Let's Encrypt -pyynnön ja palauttaa oman paikkamerkkisivunsa — vahvistus epäonnistuu. Ratkaisu on vaihtaa ”DNS only” -tilaan (harmaa pilvi) tai määrittää DNS-01-haaste Cloudflare API:n kautta.
3. DNS ei ole vielä päivittynyt. Jos loit A-tietueen 30 sekuntia sitten ja napsautit heti Redeploy, Let's Encrypt ei löydä verkkotunnustasi. Odota 5–30 minuuttia, jotta DNS päivittyy palvelimille.

Let's Encryptin pyyntöraja: 5 epäonnistunutta yritystä tunnissa yhtä verkkotunnusta kohti, ja raja palautuu yksi yritys kerrallaan 12 minuutissa. Jos saavutat rajan, älä napsauta Redeploy 10 kertaa peräkkäin; tarkista lokit, korjaa ongelma ja yritä uudelleen 12 minuutin kuluttua.

Miten Claude Code hallitsee Coolifyta MCP:n kautta?#

Model Context Protocol (MCP) on Anthropicin standardi, jonka avulla Claude Code voi viestiä ulkoisten järjestelmien kanssa (lisätietoja MCP-palvelinten oppaassa). Yhdistä MCP-palvelin, niin Claude saa joukon käytettävissä olevia työkaluja. Coolifylle on tarjolla kolme valmista palvelinta ja yksi natiivi vaihtoehto.

Vaihtoehto 1. forsonny/Coolify-MCP-Server-for-Claude-Code — perustaso.

Mitä se osaa:

• Sovellukset: luoda, käynnistää, pysäyttää, käynnistää uudelleen
• Palvelut: luetteloida, luoda, käynnistää/pysäyttää/käynnistää uudelleen
• Käyttöönotot: tarkastella käynnissä olevia, hakea UUID:n perusteella
• Tiimit ja jäsenet: luetteloida, hakea tietoja
• SSH-avaimet: luetteloida, luoda
• Ympäristömuuttujat: sovellusten ja palveluiden täydet CRUD-toiminnot
• Palvelintiedot: verkkotunnukset palvelimittain, kunto, versio

Asennus:

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

Sen jälkeen voit kirjoittaa Claude Codessa:

Näytä Coolifyn my-vibe-app-sovelluksen tila ja kolme viimeisintä käyttöönottoa.

Claude palauttaa taulukon.

Vaihtoehto 2. dazeb/coolify-mcp-enhanced — laajennettu (suositus).

Se lisää perusominaisuuksiin seuraavat:

• PostgreSQL / Redis / MinIO käyttöön yhdellä napsautuksella AI:n avulla — pyydä ”määritä Postgres minulle”, niin se luo kontin ja palauttaa DATABASE_URL-osoitteen
• Reaaliaikainen valvonta + resurssien käyttö — kunkin sovelluksen CPU/RAM reaaliajassa
• Ympäristömääritysten joukkomuokkaus — päivitä 20 muuttujaa yhdellä komennolla
• Docker Compose -tuki — ota käyttöön usean palvelun sovelluksia

Claude Coden määritys (.mcp.json projektin juuressa):

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

Vaihtoehto 3. ajmcclary/Coolify-Manager — CLI:n ympärille rakennettu Claude Skill.

Se ei ole MCP-palvelin vaan Claude Code Skill, joka käärii virallisen Coolify CLI:n. Se sisältää:

• Palveluiden ja konttien kuntodiagnostiikan
• SSL-varmenteiden diagnostiikan
• Usean instanssin tuen (jos sinulla on useita Coolify-palvelimia)
• Vianmääritysohjeita

Asennus: lataa skill ja sijoita se kansioon ~/.claude/skills/coolify-manager/. Claude Code tunnistaa sen ja tarjoaa sitä sopiviin tehtäviin.

Vaihtoehto 4 (uusi toukokuussa 2026). Coolifyn natiivi MCP versiossa v4.1.0.

v4.1.0:n muutosloki, jonka päiväys on May 18, 2026, kertoo:

Lisätty instanssitason MCP-tuki, joka sisältää vain luku -työkaluja Coolify-resursseille ja API/UI:lle.

Coolify tarjoaa nyt oman MCP-päätepisteensä — voit yhdistää Claude Codeen suoraan ilman kolmannen osapuolen palvelimia. Se on toistaiseksi vain luku -tilassa (sovellusluettelot, tilat, määritykset), eikä muokkaustoimintoja ole. Se riittää kuitenkin useimpiin tehtäviin, kuten ”kerro minulle infrastruktuurista”.

Yhdistä se .mcp.json-tiedoston kautta:

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

Odota, että natiivi MCP saa täydet kirjoitusoikeudet versiossa v4.2 tai v4.3 — Coolifyn tiimi lupasi ne vuoden 2026 loppuun mennessä.

5 sudenkuoppaa ensimmäisessä käyttöönotossa — ja niiden välttäminen#

Sudenkuoppa 1: Alle 2 GB RAM-muistia — asennus epäonnistuu OOM-virheeseen.

Oire: curl install.sh etenee komentoon docker pull coolify/coolify, jumiutuu 70 %:n kohdalla, minkä jälkeen prosessi tapetaan ilmoituksella Killed (signal 9). dmesg | tail -lokit näyttävät Out of memory: Killed process.

Ratkaisu:

# Luo 4 GB:n swap-tiedosto ongelman tilapäiseksi ratkaisemiseksi
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

Pitkällä aikavälillä päivitä RAM-muisti 4 GB:iin. Coolify toimii swapin kanssa, mutta suurten Next.js-projektien koontiversiot voivat epäonnistua.

Sudenkuoppa 2: UFW on käytössä, mutta Docker avaa silti portteja.

Oire: Otit UFW:n käyttöön ja suljit kaikki portit lukuun ottamatta porttia 22, mutta sovellukseesi pääsee edelleen internetistä jossakin satunnaisessa portissa (kuten portissa 3000).

Virallisen dokumentaation mukaan syy on tämä:

Ratkaisu: käytä palveluntarjoajasi hallintapaneelin palomuuria, älä UFW:tä. Timewebissä / Selectelissä / Aezassa on ”Firewall”- tai ”Network → Firewall” -osio, jossa voit määrittää säännöt virtuaaliverkon tasolla — ne vaikuttavat ennen kuin paketit pääsevät Dockeriin.

Vaihtoehtona on ufw-docker, skripti, joka korjaa UFW:n yhteensopivaksi Dockerin kanssa. Se on kuitenkin monimutkaisempi ratkaisu kuin napsautus hallintapaneelissa.

Sudenkuoppa 3: Cloudflare-välityspalvelu (oranssi pilvi) rikkoo Let's Encryptin.

Oire: Redeployn jälkeen lokit näyttävät Let's Encrypt validation failed - challenge returned 403.

Syy: Cloudflare välittää Let's Encryptin HTTP-pyynnön ja palauttaa oman sivunsa haaste-tiedostosi sijasta.

Ratkaisu — valitse toinen kahdesta vaihtoehdosta:

1. Vaihda ”DNS only” -tilaan (Cloudflaren harmaa pilvi). Haittapuoli: menetät Cloudflare CDN:n ja suojauksen.
2. Määritä DNS-01-haaste Cloudflare API:n kautta. Siirry Coolifyssa kohtaan Settings → SSL Configuration, valitse Cloudflare-palveluntarjoaja ja anna API-tunnus, jolla on Zone:Read- ja DNS:Edit-käyttöoikeudet. Let's Encrypt vahvistaa TXT-tietueen kautta HTTP:n sijasta.

Toisen vaihtoehdon määritys on monimutkaisempi, mutta Cloudflare-välityspalvelu säilyy käytössä.

Sudenkuoppa 4: PAT GitHub Appin sijasta — PR-esikatselut eivät toimi.

Oire: Yhdistit GitHubin Personal Access Token -tunnuksella; kaikki toimii, mutta PR-esikatselukäyttöönottoja ei luoda. Avasit PR:n GitHubissa, mutta mitään ei ilmestynyt Coolifyyn.

Syy: PR-esikatselut ovat yksinomaan GitHub Appin ominaisuus. PAT ei vastaanota pull_request-tapahtumia webhookin kautta.

Ratkaisu: yhdistä GitHub uudelleen Appin kautta. Sources → Add → GitHub App → suorita ohjattu määritys. Voit poistaa vanhan PAT-lähteen.

Sudenkuoppa 5: ”Coolify == Vercel” ei ole täysin totta.

Mitä Coolify ei tee suoraan pakkauksesta otettuna:

Jos projektisi on suurliikenteinen SaaS, jolla on maailmanlaajuinen yleisö ja alle < 100 ms:n viivevaatimus maailmanlaajuisesti, Coolify ei sovi siihen; valitse Vercel Enterprise. Jos olet vibe-koodaaja, jonka MVP:tä testaa 100–1,000 käyttäjää päivässä, Coolify kattaa kaiken.

Rehellisestä itsehostausanalyysistä:

Oppaan otsikossa mainitut 15 minuuttia viittaavat yhden projektin ensimmäisen käyttöönoton mutkattomaan polkuun. Kattava infrastruktuurin määritys valvontoineen, varmuuskopioineen ja hälytyksineen vie illan tai pari. Ole itsellesi rehellinen.

Miten vertaat vuosikuluja Verceliin?#

Alla olevat Vercel-luvut ovat artikkelin toukokuun 2026 skenaarioarvioita, eivät nykyisiä tarjouksia. Ne ovat vain vertailun toinen puoli. Itse ylläpidetyllä Coolifylla ei ole lisenssimaksua, mutta VPS, varmuuskopiot, tallennustila, liikenne ja ylläpito maksavat. Hanki edellä kuvattuihin vaatimuksiin sopiva tarjous. Skenaarioihin ei annettu numeerista VPS-hintaa, joten kiinteää säästöä ei voi väittää.

Olkoon C valitun VPS:n, varmuuskopiotallennuksen, lisäliikenteen, valvonnan ja mahdollisen maksullisen hallintapaneelin kuukausilasku yhteensä. Laske jokainen kulu kerran. Olkoon r ylläpitotyön tuntihintasi ja käytä samaa valuuttaa kauttaaltaan. Artikkelin aika-arvio on aluksi 5–10 tuntia ja sen jälkeen 1–2 tuntia kuukaudessa: 17–34 tuntia ensimmäisenä vuonna ja 12–24 tuntia myöhempinä vuosina.

Käytä eri C:tä jokaiselle skenaariolle, jos työmäärät tarvitsevat erikokoiset palvelimet. Jaa kuukausivertailussa alkuasennusaika 12 kuukaudelle: ensimmäisen vuoden kuukausivastaavuus on C + (17–34)r/12. Myöhempien vuosien kokonaiskulu on 12C + (12–24)r. Kaavat vertaavat ilmoitettua Vercel-arviota itse ylläpidon kuluihin. Lisää vastaava ylläpitokulu myös Vercel-puolelle. Negatiivinen säästö tarkoittaa itse ylläpidon olevan kalliimpaa antamillasi arvoilla. Älä laske saman ylläpitäjän koko palkkaa uudelleen, jos r sisältää sen jo.

Täytä ennen vaihtamista C todellisesta palveluntarjoajan tarjouksesta ja varmuuskopiosuunnitelmasta, valitse r ja vertaa sitten kuukauden toteutunutta käyttöä. Ilman näitä arvoja artikkeli tukee kulumallia, ei dollarimääräistä säästöväitettä.

Suurin hyöty ei ole raha. Kun siirryt Coolifyyn, kategoria ”riippuvainen jonkun toisen maksukäytännöistä” katoaa. Virtuaalisia välittäjäkortteja ja niiden 20 %:n palkkiota ei enää tarvita.

Coolify on eri tuotekategoria: omistat infrastruktuurin ja vastaat siitä. Mahdollinen säästö riippuu todellisesta infrastruktuurilaskusta ja ylläpitotyön hinnasta; monimutkaisuuden hyväksyminen ei itsessään takaa säästöä.

Jos prototyypin käyttöönotto on ensimmäinen tehtäväsi Claude Code -generoinnin jälkeen, ympäristön (env, salaisuudet, ajastetut tehtävät, varmuuskopiot) hallinta kuuluu konteksti-insinöörityöhön. Ilman rakennetta sille, ”missä kaikki sijaitsee”, Claude eksyy ja menetät aikaa jokaisessa muutoksessa. Kattava kokoonpano sisältää: AI-klooni (Skills ja Subagents, jotka on räätälöity menetelmääsi) + Second Brain (projektin tietämyskanta) + Context Engineering (Plan Mode, /compact, suoritusympäristö). Nämä ovat 3 peruspilaria, joita ilman AI hallusinoi.

Täydellinen kontekstityönkulku: AI-klooni + Second Brain + Context Engineering.

Lisää materiaalia on saatavilla Ailootissa.