SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

Paano Mag-install ng Cloudron sa VPS

Alamin ang tamang Ubuntu VPS, wildcard DNS record, setup script at reboot para sa Cloudron, kasama ang sizing para sa 2 hanggang 10 app, mail, TLS certificate at backups.

Mag-install ng Cloudron sa isang VPS: maikling bersyon

Para mag-install ng Cloudron sa isang VPS, kailangan mo ng bagong Ubuntu server, hindi bababa sa 2 GB RAM, at domain na mae-edit mo ang mga DNS record. Ang mismong installation ay tatlong command at isang reboot. Halos lahat ng nagiging problema ay nangyayari bago ang hakbang na iyon (maling base image, maling virtualization type) o pagkatapos nito (DNS, mail, backups).

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

Nag-i-install, nag-a-update, nagba-back up, at nag-i-issue ang Cloudron ng mga TLS (transport layer security) certificate para sa self-hosted app. Tumatakbo ang bawat app sa Docker, nasa harap ng lahat ng ito ang nginx, at may sariling subdomain ng iyong domain ang bawat app. Dahil dito, DNS ang unang kailangang i-configure.

Bakit mahigpit ang Cloudron sa base OS

Sinusuri ng setup script ang server bago ito mag-install ng anuman. Kapag nabigo ang isang check, kailangan kang mag-order ng bagong server. Basahin ang mga check na ito bago pumili ng image. Ang mga installer check na sinipi sa seksyong ito ay mula Oktubre 13, 2026; hinihingi na ngayon ng kasalukuyang installation documentation ang isang bagong Ubuntu 26.04 server.

  • Ubuntu lamang, at tatlong release lamang. Anumang iba ay lalabas na may Cloudron requires Ubuntu 22.04, 24.04, 26.04. Tinatanggihan ang Ubuntu 20.04, at hinihingi na ngayon ng installation documentation ang isang bagong Ubuntu 26.04 server. Hindi supported ang Debian, Rocky, at Alpine. Kailangan ng Ubuntu 24.04 ang Cloudron 8 o mas bago, at awtomatikong sinusuri iyon ng script.
  • 64-bit Intel o AMD lamang: Error: Cloudron only supports amd64/x86_64. Hindi ito maaaring tumakbo sa ARM VPS.
  • Full hardware virtualisation lamang. Sa container-based VPS, hihinto ang script na may Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization dahil nade-detect nito ang container gamit ang systemd-detect-virt --container. Ayos ang KVM. Hindi supported ang OpenVZ at LXC.
  • Kailangang ext4 o xfs ang root filesystem. Sa ibang filesystem, makakakuha ka ng Error: Cloudron requires '/' to be ext4 or xfs. Ganito nabibigo ang mga btrfs at zfs image.
  • Hindi bababa sa 941 MB na RAM, sinusukat gamit ang free -m, at 18 GB sa /, na sinusukat bilang laki ng root filesystem. Humihingi ang error message ng 20GB, pero pumapasa ang mismong check sa 19 GB na root filesystem.
  • Talagang bagong server. Kung naka-install na ang nginx, docker, o node, tatanggi ang script at maglalabas ng Error: Some packages like nginx/docker/nodejs are already installed.

Ang huling check ang madalas pinagtatalunan, kaya narito ang dahilan. Nag-i-install ang Cloudron ng mga nakapirming bersyon ng Docker, nginx, Node.js, at MySQL. Sinusulat nito ang nginx configuration para sa bawat app na sini-host nito, at ito mismo ang namamahala sa mga iptables firewall rule. Mali ang bersyon ng Docker na na-install mo kahapon, kaya lalabas ang script nang walang binabago at sasabihin nitong magsimula ka sa bagong Ubuntu installation. Pagmamay-ari ng Cloudron ang buong machine, kaya bigyan ito ng dedicated VPS.

May isa pang check na madaling hindi mapansin. Sa mas lumang CPU na walang AVX (advanced vector extensions), ipi-print ng script ang CPU has no AVX support. MongoDB will be disabled, at magiging hindi maaaring i-install ang bawat app na nangangailangan ng MongoDB. Suriin ang CPU bago magpasya gamit ang grep -m1 -o avx /proc/cpuinfo. Ipi-print nito ang avx sa host na may kakayahan, at walang ipi-print sa lumang host.

Gaano karaming RAM ang kailangan ng Cloudron?

Tumangging tumakbo ang installer check noong October 13, 2026 sa ilalim ng 941 MB, na may Error: Cloudron requires atleast 1GB physical memory; hinihingi naman ng kasalukuyang documentation ang 2 GB na RAM at 20 GB na disk. Minimum requirement ng platform ang dalawang numerong ito, hindi ng platform kasama ang mga app mo. Pinapatakbo ng Cloudron ang Docker, nginx, sarili nitong box service, at mail stack. Nagse-set up din ito ng mga shared database service habang nagde-deploy ka ng mga app. Patakbuhin ang docker ps sa bagong install at bilangin ang mga ito.

Bukod pa sa base na ito ang memory limit ng bawat app. May mababang default limit ang bawat app package, at maaari mo itong itaas gamit ang slider sa Resources view ng app. Kapag lumampas ang app sa limit nito, magre-restart ito at magpapadala sa iyo ng OOM (out of memory) notification. Kaya kung paulit-ulit na nagre-restart ang isang app sa server, karaniwang limit problem ito at hindi bug.

Ito ang sizing na irerekomenda kong i-order. Mga rekomendasyon ito para sa server na hindi mo kailangang i-rebuild sa susunod na buwan. Hindi ito mga resulta mula sa aktuwal na benchmark.

TsartCloudron VPS sizing floor by number of apps
Ang datos sa likod ng tsart na ito
[
  {
    "label": "2 apps (free tier)",
    "vcpu": 2,
    "ram_gb": 4,
    "disk_gb": 60
  },
  {
    "label": "5 apps",
    "vcpu": 4,
    "ram_gb": 8,
    "disk_gb": 120
  },
  {
    "label": "10 apps",
    "vcpu": 6,
    "ram_gb": 16,
    "disk_gb": 240
  }
]

Komportable ang dalawang app sa 4 GB na RAM at 60 GB na disk. Para sa humigit-kumulang sampung app, kailangan ng 16 GB at 240 GB, dahil hindi lumiit ang platform base at nagdaragdag ang bawat app ng Docker image, database, at sarili nitong data. Mas mabilis mapuno ang disk kaysa sa inaasahan ng marami: nagsi-share ang images, app data, at local backups ng iisang volume hanggang ilipat mo sa labas ng server ang mga backup.

Binibigyan ng Cloudron ang bawat app ng unlimited swap, kaya RAM lamang ang saklaw ng memory limit na itinatakda mo. Sa isang VPS image na walang swap file, walang inilalabas ang swapon --show, at direktang nagiging OOM restart ang memory pressure sa halip na mabagal lang ang app. Murang dagdag na insurance ang 2 GB na swap, pero hindi nito napapalitan ang aktuwal na memory. Maliit ang agwat ng presyo ng mga VPS plan kumpara sa mga oras na gugugulin mo sa pag-tune ng mga limit. Kaya tingnan ang aktuwal na gastos ng VPS at piliin ang susunod na mas malaking size.

DNS: ang wildcard record para gumana ang mga app subdomain

Inilalagay ng Cloudron ang dashboard sa my.example.com at ang bawat app sa sarili nitong subdomain, kaya prerequisite ang DNS at hindi ito dapat ipagpaliban. Ituro ang mga record na ito sa public IP address ng server bago mo unang buksan ang dashboard:

  • my.example.com bilang A record. Ito ang dashboard.
  • *.example.com bilang A record. Ito ang nagpapagana sa mga app subdomain, kaya magre-resolve agad ang wiki.example.com at git.example.com kapag na-install mo ang mga app na iyon.
  • example.com bilang A record, kung gusto mong magpatakbo ng app sa bare domain.

Mas mababa ang precedence ng wildcard record kaysa sa explicit record, kaya patuloy na gagana ang umiiral na www.example.com kung may iba itong tinuturong lokasyon.

Sa setup, pipiliin mo kung paano hahawakan ng Cloudron ang DNS mula noon:

  • Isang API provider. Nag-iimbak ang Cloudron ng token para sa Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS at iba pa (22 API DNS integration sa kabuuan, hindi kasama ang Wildcard, Manual at No-op), pagkatapos ay ito mismo ang nagsusulat ng bawat record, kabilang ang mga mail record.
  • Wildcard. Ikaw mismo ang magdaragdag ng * record at walang isusulat ang Cloudron.
  • Manual. Ipinapakita ng Cloudron ang bawat record at maghihintay habang idinaragdag mo ito bago ang bawat pag-install ng app.

Ang wildcard DNS record ay hindi wildcard certificate. Ang default na certificate provider ay Let's Encrypt Prod - Wildcard. Pinatutunayan nito ang ownership sa pamamagitan ng DNS, kaya gumagana lamang ito sa isang API provider. Sa Wildcard o Manual backend, nag-i-issue ang Let's Encrypt ng mga indibidwal na certificate na vine-validate sa HTTP. Kailangan nito ang inbound port 80 para sa issuance at renewal. Maaari mong i-disable ang Let's Encrypt integration at mag-upload ng custom wildcard certificate, kaya hindi permanenteng kinakailangan ang port 80 para sa certificate validation. Kung nasa API list ang registrar o DNS host mo, iyon ang gamitin: hindi mo na kailangang pamahalaan ang mail records at certificates.

Mag-verify bago magpatuloy. Dapat parehong i-print ng dig +short my.example.com at dig +short anything.example.com ang IP address ng server mo. Sa Wildcard backend, kung walang i-print ang wildcard query, mabibigo ang mga app sa susunod kahit gumagana nang maayos ang dashboard.

Kung nasa likod ng Cloudflare ang domain, itakda ang mga record sa DNS only. HTTP at HTTPS lamang ang ipinapasa ng proxy, kaya hindi gagana ang mga mail port. Para sa mga web app na dumadaan sa proxy, sinusuportahan ng Network view ng Cloudron ang pagtitiwala sa mga published IP range ng Cloudflare upang maibalik ang address ng bisita mula sa forwarded headers.

Patakbuhin ang setup script

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

Patakbuhin ito bilang root o sa pamamagitan ng sudo, dahil kung hindi, ang unang ipi-print nito ay This script should be run as root.. Tumatagal nang ilang minuto ang installation at walang output habang isinasagawa ito, dahil napupunta sa log file ang output ng apt at ang Docker pulls. I-monitor ito mula sa ikalawang SSH session:

tail -f /var/log/cloudron-setup.log

Sa installer check noong October 13, 2026, nag-print ito ng After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. na sinundan ng address ng server, at pagkatapos ay nagtanong ng The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Sagutin ito ng yes. Nagbigay rin ang installer na iyon ng --skip-reboot flag upang ipagpaliban ang restart.

Unang boot: domain, DNS backend at admin account

Buksan ang https://<server-ip> at tanggapin ang babala ng browser. Self-signed ang certificate dahil hindi pa alam ng Cloudron ang domain mo, kaya wala pa itong mapagkukunan ng certificate sa isang certificate authority. Sa Chrome, i-click ang Advanced, at pagkatapos ay Proceed to <ip> (unsafe). Sa Firefox, i-click ang Advanced, at pagkatapos ay Accept the Risk and Continue.

Hinihingi ng unang screen ang domain mo. Ilagay ang example.com at mapupunta ang dashboard sa my.example.com. Maaari ka ring gumamit ng subdomain gaya ng cloudron.example.com, at magiging my.cloudron.example.com ang dashboard address. Piliin ang DNS backend, i-paste ang API token kung mayroon ka, at gawin ang admin account gamit ang email address na regular mong nababasa. Dito ipapadala ang mga password reset at notification ng platform.

Kapag na-save mo ito, hihingi ang Cloudron ng mga certificate at ililipat ang dashboard sa https://my.example.com. Hindi na gagana ang URL na gumagamit ng IP address, kaya i-bookmark ang bagong URL.

Mga certificate: ano ang nagre-renew at kailan ito humihinto

Awtomatiko ang pag-renew ng certificate at sumusunod ito sa ACME Renewal Information (ARI), ang iskedyul na inilalathala ng certificate authority. Sa aktuwal na paggamit, karaniwang nagre-renew ito mga isang buwan bago ang expiry. Kapag nabigo ang pag-renew, magpapadala ng email sa admin account. Kapag nag-expire ang certificate, gagamitin ang built-in na self-signed certificate. Ito ang dahilan kung bakit may browser warning sa isang site na gumana pa kahapon.

Dalawang sanhi ang responsable sa karamihan ng mga kaso. Kailangan ng HTTP validation ang inbound port 80. Kaya kapag isinara ang port 80 dahil “HTTPS naman ang lahat,” mabibigo ang pag-renew ng mga app na gumagamit ng Let's Encrypt HTTP validation sa isang Wildcard o Manual DNS backend. Kailangan naman ng DNS validation ng API token na may write access pa rin. Kaya kapag ni-rotate o nilimitahan ang token, tahimik na mabibigo ang pag-renew hanggang dumating ang warning email.

May Renew All button ang Domains view upang agad na pilitin ang pagtatangka. Mayroon ding Let's Encrypt Staging provider para sa testing. Sadyang hindi pinagkakatiwalaan ng mga browser ang staging certificate. Iyon ang layunin nito: naiiwasan ng testing ang paggamit sa production rate limits. May sarili ring limits ang staging, kabilang ang 200 authorization failures bawat identifier, bawat account, bawat oras.

Dapat mo bang gamitin ang built-in mail server?

Naglalabas ang Cloudron ng kumpletong mail stack na may IMAP mailboxes, submission, sieve filters, at DKIM (domainkeys identified mail) signing. I-enable ito para sa bawat domain sa ilalim ng Email sa dashboard. Ang mahirap ay ang pagpapadeliver ng mail, at hindi Cloudron ang pinagmumulan ng mga hamong ito.

  • Bina-block ng karamihan ng VPS provider ang outbound port 25 bilang kontrol laban sa spam. May ilang nag-a-unblock nito kapag nagsumite ka ng support ticket. Mag-test mula sa server gamit ang nc -zv aspmx.l.google.com 25 (i-install ang netcat-openbsd kung wala ang command). Iniuulat ng succeeded ang mga bukas na port, at mananatiling naka-hang ang blocked port hanggang mag-timeout.
  • Ang PTR record (reverse DNS) ay sine-set ng iyong VPS provider, hindi ng iyong DNS host, at kailangang tumugma ito sa mail hostname kapag direktang nagpapadala ka mula sa server. Inaalis ng smart host ang requirement na ito para sa PTR.
  • Awtomatikong isinusulat ang SPF, DKIM, at DMARC records kapag API DNS backend ang gamit. Sa Wildcard o Manual backend, mano-mano mong idinadagdag ang mga ito. Kapag nawawala ang DKIM record, hindi mabe-verify ang bawat mensaheng sina-sign mo.

Para sa karamihan, ang setup na gumagana ay tumanggap ng mail sa Cloudron at magpadala sa pamamagitan ng relay gaya ng SendGrid, Postmark, Mailgun, o Amazon SES, na kino-configure sa Email view. Kailangang payagan ng relay ang pagpapadala gamit ang anumang address sa iyong domain. Kung hindi, mare-reject ang mga app notification mula sa magkakaibang sender. Kung mail ang pangunahing dahilan ng pagbili mo ng server, magpatakbo ng dedicated mail server gaya ng Mailcow sa sarili nitong machine at may sarili nitong IP reputation.

Kung hindi mo gagamitin ang Cloudron Email, i-block ang ports 25, 465, 587, 993, at 4190 sa firewall ng iyong provider. Doon mo ito gawin, hindi sa server, dahil ang Cloudron ang nagsusulat ng iptables rules at inaasahang ito ang mamamahala sa mga ito. Kabaligtaran ito ng plain VPS, kung saan ikaw mismo ang namamahala sa ufw rules.

I-configure ang backup target bago mo ito kailanganin

Naka-default ang backups sa local filesystem sa /var/backups, sa parehong disk na ginagamit ng lahat ng iba pa. Malinaw ang dokumentasyon tungkol dito: "Mapanganib kapag nasa parehong physical disk ng platform server ang backups." Isang sirang disk lang at sabay mawawala ang apps at backups.

Buksan ang Backups, pagkatapos ay Backup Sites, at ituro ito sa ibang lokasyon sa unang araw pa lang. Karaniwang ginagamit ang S3-compatible object storage (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces, o isang MinIO bucket sa pangalawang server). Sinusuportahan din ang SSHFS, NFS, CIFS, at plain filesystem targets.

Tatlong setting ang nagtatakda kung kapaki-pakinabang ang backup na iyon:

  • Format. Ang tgz ay nagsusulat ng isang compressed archive para sa bawat app at muling ina-upload ang buong archive sa bawat run. Ang rsync ay mga binagong file lamang ang ina-upload, kaya mas mura ito para sa malaking Nextcloud, kapalit ng mas maraming request sa storage API.
  • Encryption. Opsyonal na AES-256 na sumasaklaw sa file contents at filenames. Walang kopya ng password ang Cloudron, kaya kapag nawala ito, walang makakapag-decrypt ng backups, pati ikaw. I-store ito sa isang self-hosted password manager bago mo i-click ang save.
  • Retention. Isinusulat ito bilang mga bilang gaya ng 7 daily at 4 weekly. Bawat buwan kang sisingilin ng mahahabang retention period sa object storage, kaya pumili ng bilang na handa mong patuloy na bayaran.

Pagkatapos, subukan ang restore. Mag-install ng maliit na app, i-restore ito mula sa dashboard, at obserbahan kung bumalik ito kasama ang data nito. Ang backup na hindi pa kailanman na-restore ay hula lamang.

Mga limitasyon ng free tier

Noong October 2026, limitado sa dalawang naka-install na app ang free plan. Kasama na rito ang lahat ng iba pa: mga update ng app, backup ng bawat app, firewall, mail server, at single sign-on. Sa ikatlong app kinakailangan na ang licence. Inaalis ng paid plans ang limit sa bilang ng app. Nagdaragdag naman ang mas mataas na plan ng user groups at roles, directory server, at maraming backup site. Nagbabago ang mga presyo, kaya tingnan ang Cloudron pricing page sa halip na umasa sa numerong nasa tutorial.

Saklaw ng isang licence ang isang Cloudron install. Kaya dalawang maliit na server ang dalawang beses ang gastos kumpara sa isang mas malaking server. Dahil sa ganitong pricing, karaniwang napipilitan ang mga user na gumamit ng isang mas malaking VPS. Salungat ito sa karaniwang payo na ipamahagi ang mga serbisyo sa maraming machine. Isaalang-alang ito sa pag-size ng server, dahil kapag hinati ang mga serbisyo sa ibang pagkakataon, dalawang beses ang magiging bayad.

Kapag may hindi gumagana

Magsimula sa built-in na check. Isa-isa nitong sinusuri ang DNS, certificates, disk, memory, at bawat service. Sinasabi rin nito kung aling test ang nag-fail:

sudo cloudron-support --troubleshoot

Pagkatapos, gamitin ang karaniwang systemd (system at service manager) tools. Iniuulat ng systemctl status box ang mismong Cloudron service, ipinapakita ng journalctl -u box -n 100 ang mga kamakailang log nito, at sinusuri ng journalctl -u docker ang container runtime sa ilalim nito. Nananatili sa /var/log/cloudron-setup.log ang anumang problemang nangyari habang nag-i-install.

Karaniwang DNS o firewall ng provider ang sanhi kapag hindi naglo-load ang dashboard, hindi ang Cloudron. Patakbuhin ang dig +short my.example.com mula sa iyong laptop at tiyaking bukas ang ports 80 at 443 sa network firewall ng provider. Hiwalay itong control sa sariling rules ng server. Sa installer check noong October 13, 2026, tinanggihan ang ikalawang run gamit ang Error: Cloudron is already installed. To reinstall, start afresh; ang malinis na solusyon ay mag-rebuild ng server.

Kapag hindi angkop ang Cloudron

Ang Cloudron ay angkop kung mga application ang gusto mong patakbuhin, hindi infrastructure. Hindi ito gaanong angkop kung gusto mong patakbuhin ang sarili mong containers sa sarili mong paraan, dahil ito ang namamahala sa nginx, Docker, at firewall, at mao-overwrite nito ang mga inilagay mo roon. Kung ang plano mo ay isang folder ng compose files, ibinibigay ng Traefik sa harap ng sarili mong Docker Compose stacks ang parehong automatic TLS at subdomain routing nang walang platform na nakapatong dito. Kung hindi ka pa nakakapili, magkatabing inihahambing ng paghahambing ng Cloudron, CasaOS, at Coolify ang mga ito, at mas magandang panimulang lugar kaysa install guide ang mas malawak na listahan ng mga maaaring i-self-host.

FAQ

Gaano karaming RAM ang kailangan ng Cloudron sa isang VPS?

Tumangging tumakbo ang installer check noong October 13, 2026 kapag mas mababa sa 941 MB ang available na RAM; 2 GB ang hinihingi ng kasalukuyang documentation, pero ito ang minimum lamang para sa platform na walang app. Pinapatakbo ng Cloudron ang Docker, nginx, sarili nitong box service, at mail stack nito. Nagse-set up din ito ng shared database services habang nagde-deploy ng mga app. Maglaan ng 4 GB para sa dalawang app at 16 GB para sa humigit-kumulang sampung app. Magdagdag din ng swap file, dahil walang limitasyon ang swap na maaaring gamitin ng mga app sa Cloudron. Kapag walang swap ang server, maaaring mauwi sa mga restart ang memory pressure.

Maaari ko bang i-install ang Cloudron sa Debian, o sa server na nagpapatakbo na ng Docker?

Hindi gagana ang alinman sa mga ito. Sa installer check noong October 13, 2026, huminto ang script sa mga hindi suportadong release na may Cloudron requires Ubuntu 22.04, 24.04, 26.04. Tumanggi rin ito sa mga server na mayroon nang nginx, docker, o node. Nangangailangan ang kasalukuyang installation documentation ng bagong Ubuntu image at hindi nito sinusuportahan ang Debian, Rocky, o Alpine. Magsimula sa bagong Ubuntu image sa isang KVM VPS.

Bakit hindi gumagana ang mga app subdomain ko kahit gumagana ang dashboard?

Sa Wildcard backend, suriin ang wildcard DNS record. Gumagawa o nangangailangan ang setup ng A record para sa my.example.com. Dahil dito, nareresolve ang dashboard, samantalang nagbabalik ang wiki.example.com ng NXDOMAIN at ipinapakita ng browser na hindi makita ang site. Magdagdag ng A record para sa *.example.com na nakaturo sa IP address ng server. Pagkatapos, kumpirmahin ito gamit ang dig +short wiki.example.com bago i-install ang app.

Kailangan ko bang gamitin ang mail server ng Cloudron?

Hindi. Maaari mong i-off ang incoming email at gumamit ng external relay gaya ng Postmark, Mailgun, o Amazon SES. Mas ligtas ito kapag hinaharangan ng provider mo ang outbound port 25 o walang mail reputation ang IP address. Kung hindi mo gagamitin ang Cloudron Email, isara ang ports 25, 465, 587, 993, at 4190 sa provider firewall sa halip na sa server.

Ano ang mangyayari kapag naabot ko ang limitasyong dalawang app sa free plan?

Kailangan mo ng paid subscription para makapag-install ng ikatlong app. Hindi maaapektuhan ang mga app na tumatakbo na: magpapatuloy ang kanilang updates, backups, at certificates. Kapag nagdagdag ka ng subscription, aalisin ang limitasyon nang hindi kailangang mag-reinstall. Dahil dito, makatuwirang paraan ang free plan para subukan muna ang platform gamit ang totoong domain.

Nakatulong ba ang artikulong ito?