SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Instal Cloudron di VPS Ubuntu

Panduan instal Cloudron di VPS Ubuntu baru, termasuk error OS, wildcard DNS, skrip penyiapan, kebutuhan RAM 2 GB, email, sertifikat TLS, dan backup.

Instal Cloudron pada VPS: versi singkat

Untuk menginstal Cloudron pada VPS, Anda memerlukan server Ubuntu baru, RAM minimal 2 GB, dan domain yang catatan DNS-nya dapat Anda ubah. Proses instalasinya sendiri terdiri dari tiga perintah dan satu kali reboot. Hampir semua masalah terjadi sebelum tahap tersebut (image dasar yang salah, jenis virtualisasi yang salah) atau setelahnya (DNS, email, backup).

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

Cloudron menginstal, memperbarui, mencadangkan, dan menerbitkan sertifikat TLS (transport layer security) untuk aplikasi self-hosted. Setiap aplikasi berjalan dalam Docker, nginx berada di depan semuanya, dan setiap aplikasi mendapatkan subdomain sendiri dari domain Anda. Detail terakhir inilah yang membuat konfigurasi DNS harus dilakukan terlebih dahulu.

Mengapa Cloudron ketat terhadap OS dasar

Skrip penyiapan memeriksa server sebelum menginstal apa pun. Kegagalan pada salah satu pemeriksaan berarti Anda harus memesan server baru. Baca persyaratan ini sebelum memilih image. Pemeriksaan installer yang dikutip di bagian ini berasal dari 13 Oktober 2026. Dokumentasi instalasi saat ini meminta server Ubuntu 26.04 yang baru.

  • Hanya Ubuntu, dan hanya tiga rilis. Sistem lain akan keluar dengan Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 ditolak, dan dokumentasi instalasi kini meminta server Ubuntu 26.04 yang baru. Debian, Rocky, dan Alpine tidak didukung. Ubuntu 24.04 memerlukan Cloudron 8 atau yang lebih baru. Skrip memeriksa hal ini untuk Anda.
  • Hanya Intel atau AMD 64-bit: Error: Cloudron only supports amd64/x86_64. VPS ARM tidak dapat menjalankannya.
  • Hanya virtualisasi perangkat keras penuh. Pada VPS berbasis container, skrip berhenti dengan Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization karena mendeteksi container menggunakan systemd-detect-virt --container. KVM dapat digunakan. OpenVZ dan LXC tidak dapat digunakan.
  • Sistem berkas root harus berupa ext4 atau xfs. Pada sistem lain, Anda akan mendapatkan Error: Cloudron requires '/' to be ext4 or xfs. Inilah penyebab image btrfs dan zfs gagal.
  • RAM minimal 941 MB, diukur menggunakan free -m, dan minimal 18 GB pada /, yang diukur berdasarkan ukuran sistem berkas root. Pesan error meminta 20GB, tetapi pemeriksaan itu sendiri menerima sistem berkas root berukuran 19 GB.
  • Server harus benar-benar baru. Jika nginx, docker, atau node sudah terinstal, skrip menolak melanjutkan dengan Error: Some packages like nginx/docker/nodejs are already installed.

Pemeriksaan terakhir sering diperdebatkan. Berikut alasannya. Cloudron menginstal versi Docker, nginx, Node.js, dan MySQL yang telah ditetapkan, menulis konfigurasi nginx untuk setiap aplikasi yang di-host, serta mengelola aturan firewall iptables sendiri. Docker yang Anda instal kemarin dapat memiliki versi yang salah. Karena itu, skrip keluar tanpa mengubah apa pun dan meminta Anda memulai dari instalasi Ubuntu yang baru. Cloudron mengelola seluruh mesin. Jadi, gunakan VPS khusus untuknya.

Ada satu pemeriksaan lain yang mudah terlewat. Pada CPU lama tanpa AVX (advanced vector extensions), skrip menampilkan CPU has no AVX support. MongoDB will be disabled. Akibatnya, setiap aplikasi yang memerlukan MongoDB tidak dapat diinstal. Periksa CPU sebelum membuat komitmen menggunakan grep -m1 -o avx /proc/cpuinfo. Perintah ini menampilkan avx pada host yang mendukungnya dan tidak menampilkan apa pun pada host lama.

Berapa banyak RAM yang dibutuhkan Cloudron?

Pemeriksaan installer pada 13 Oktober 2026 menolak berjalan jika RAM kurang dari 941 MB, dengan Error: Cloudron requires atleast 1GB physical memory; dokumentasi saat ini meminta RAM 2 GB dan disk 20 GB. Kedua angka tersebut adalah batas minimum untuk platform, bukan untuk platform beserta aplikasi Anda. Cloudron menjalankan Docker, nginx, layanan box miliknya sendiri, dan stack email, serta menyediakan layanan database bersama saat aplikasi diterapkan. Jalankan docker ps pada instalasi baru, lalu hitung hasilnya.

Batas memori aplikasi ditambahkan di atas kebutuhan dasar tersebut. Setiap paket aplikasi dirilis dengan batas default yang rendah, dan Anda dapat menaikkannya menggunakan slider pada tampilan Resources aplikasi. Jika aplikasi melewati batasnya, aplikasi tersebut akan dimulai ulang dan mengirimkan notifikasi OOM (out of memory). Jadi, server yang terus memulai ulang satu aplikasi biasanya mengalami masalah batas memori, bukan bug.

Berikut ukuran server yang saya rekomendasikan. Rekomendasi ini ditujukan untuk server yang tidak perlu Anda bangun ulang bulan depan. Angka-angka ini bukan hasil benchmark terukur.

GrafikCloudron VPS sizing floor by number of apps
Data di balik grafik ini
[
  {
    "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
  }
]

Dua aplikasi dapat berjalan dengan nyaman pada RAM 4 GB dan disk 60 GB. Sekitar sepuluh aplikasi memerlukan RAM 16 GB dan disk 240 GB, karena kebutuhan dasar platform tidak pernah berkurang dan setiap aplikasi menambahkan image Docker, database, serta datanya sendiri. Disk terisi lebih cepat daripada yang diperkirakan: image, data aplikasi, dan backup lokal menggunakan satu volume yang sama sampai Anda memindahkan backup ke luar server.

Cloudron memberikan swap tanpa batas kepada setiap aplikasi, sehingga batas memori yang Anda tetapkan hanya berlaku untuk RAM. Pada image VPS tanpa file swap, swapon --show tidak menampilkan apa pun, dan tekanan memori langsung menyebabkan aplikasi dimulai ulang karena OOM, bukan berjalan lambat. Menambahkan swap 2 GB merupakan langkah pencegahan yang murah, tetapi tidak menggantikan memori fisik. Selisih antara paket VPS biasanya kecil dibandingkan waktu yang akan Anda habiskan untuk menyesuaikan batas, jadi baca biaya VPS sebenarnya dan pilih ukuran berikutnya yang lebih besar.

DNS: record wildcard yang membuat subdomain aplikasi berfungsi

Cloudron menempatkan dasbor pada my.example.com dan setiap aplikasi pada subdomainnya sendiri. Karena itu, DNS merupakan prasyarat, bukan langkah lanjutan. Arahkan record berikut ke alamat IP publik server sebelum membuka dasbor untuk pertama kalinya:

  • my.example.com sebagai record A. Ini adalah dasbor.
  • *.example.com sebagai record A. Record ini membuat subdomain aplikasi berfungsi, sehingga wiki.example.com dan git.example.com langsung ter-resolve saat Anda memasang aplikasi tersebut.
  • example.com sebagai record A, hanya jika Anda ingin menjalankan aplikasi pada bare domain.

Record wildcard memiliki prioritas lebih rendah daripada record eksplisit. Karena itu, www.example.com yang sudah ada dan mengarah ke tempat lain akan tetap berfungsi.

Selama penyiapan, Anda memilih cara Cloudron menangani DNS setelah itu:

  • Penyedia API. Cloudron menyimpan token untuk Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS, dan lainnya (total 22 integrasi DNS API, tidak termasuk Wildcard, Manual, dan No-op), lalu menulis setiap record sendiri, termasuk record mail.
  • Wildcard. Anda menambahkan record * secara manual dan Cloudron tidak menulis apa pun.
  • Manual. Cloudron menampilkan setiap record dan menunggu Anda menambahkannya sebelum setiap pemasangan aplikasi.

Record DNS wildcard bukan sertifikat wildcard. Penyedia sertifikat default adalah Let's Encrypt Prod - Wildcard, yang membuktikan kepemilikan domain melalui DNS. Karena itu, fitur ini hanya berfungsi dengan penyedia API. Pada backend Wildcard atau Manual, Let's Encrypt menerbitkan sertifikat individual yang divalidasi melalui HTTP. Proses ini memerlukan port masuk 80 untuk penerbitan dan pembaruan. Anda dapat menonaktifkan integrasi Let's Encrypt dan mengunggah sertifikat wildcard kustom, sehingga port 80 tidak menjadi persyaratan permanen untuk validasi sertifikat. Jika registrar atau host DNS Anda ada dalam daftar API, gunakan layanan tersebut. Dengan demikian, record mail dan sertifikat tidak lagi perlu Anda kelola sendiri.

Lakukan verifikasi sebelum melanjutkan. dig +short my.example.com dan dig +short anything.example.com seharusnya sama-sama menampilkan alamat IP server Anda. Pada backend Wildcard, jika kueri wildcard tidak menampilkan apa pun, aplikasi akan gagal nantinya meskipun dasbor tetap berfungsi.

Jika domain berada di belakang Cloudflare, atur record ke DNS only. Proxy hanya meneruskan HTTP dan HTTPS, sehingga port mail akan gagal. Untuk aplikasi web yang menggunakan proxy, tampilan Network Cloudron mendukung kepercayaan terhadap rentang IP yang dipublikasikan Cloudflare agar alamat pengunjung dapat dipulihkan dari header yang diteruskan.

Jalankan skrip penyiapan

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

Jalankan sebagai root atau melalui sudo, karena jika tidak, pesan pertama yang dicetak adalah This script should be run as root.. Proses instalasi memerlukan waktu beberapa menit dan tidak menampilkan banyak keluaran saat berjalan, karena keluaran apt dan proses pull Docker ditulis ke file log. Pantau dari sesi SSH kedua:

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

Dalam pemeriksaan installer pada 13 Oktober 2026, installer mencetak After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. diikuti alamat server, lalu menanyakan The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Jawab yes. Installer tersebut juga menyediakan flag --skip-reboot untuk menunda restart.

Boot pertama: domain, backend DNS, dan akun admin

Buka https://<server-ip> dan terima peringatan browser. Sertifikat tersebut ditandatangani sendiri karena Cloudron belum mengetahui domain Anda, sehingga Cloudron belum memiliki informasi yang diperlukan untuk meminta sertifikat kepada certificate authority. Di Chrome, klik Advanced, lalu Proceed to <ip> (unsafe). Di Firefox, klik Advanced, lalu Accept the Risk and Continue.

Layar pertama meminta domain Anda. Masukkan example.com, lalu dashboard tersedia di my.example.com. Anda juga dapat menggunakan subdomain seperti cloudron.example.com, lalu dashboard tersedia di my.cloudron.example.com. Pilih backend DNS, tempelkan API token jika Anda memilikinya, lalu buat akun admin menggunakan alamat email yang benar-benar Anda baca. Pengaturan ulang password dan notifikasi platform akan dikirim ke alamat tersebut.

Setelah Anda menyimpan konfigurasi, Cloudron meminta sertifikat dan memindahkan dashboard ke https://my.example.com. URL berbasis alamat IP tidak lagi berfungsi pada tahap tersebut, jadi simpan URL baru itu sebagai bookmark.

Sertifikat: apa yang diperbarui dan kapan prosesnya berhenti

Pembaruan sertifikat berlangsung otomatis dan mengikuti ACME Renewal Information (ARI), yaitu jadwal yang dipublikasikan oleh certificate authority. Dalam praktiknya, sertifikat diperbarui sekitar satu bulan sebelum kedaluwarsa. Jika pembaruan gagal, akun admin akan menerima email. Jika sertifikat kedaluwarsa, sistem menggunakan sertifikat self-signed bawaan. Inilah yang menyebabkan peringatan browser pada situs yang kemarin masih berfungsi.

Sebagian besar kasus disebabkan oleh dua hal. Validasi HTTP memerlukan port masuk 80. Jadi, menutup port 80 karena "semuanya sudah HTTPS" akan menggagalkan pembaruan untuk aplikasi yang menggunakan validasi HTTP Let's Encrypt pada backend Wildcard atau Manual DNS. Validasi DNS memerlukan API token yang masih memiliki akses tulis. Jadi, mengganti atau mempersempit izin token tersebut akan menggagalkan pembaruan secara diam-diam sampai email peringatan diterima.

Tampilan Domains memiliki tombol Renew All untuk langsung memaksa percobaan, serta provider Let's Encrypt Staging untuk pengujian. Sertifikat Staging sengaja tidak dipercaya oleh browser. Inilah tujuannya: pengujian tidak menghabiskan rate limit produksi. Staging memiliki batasnya sendiri, termasuk 200 kegagalan otorisasi per identifier, per akun, per jam.

Apakah Anda perlu menggunakan server email bawaan?

Cloudron menyediakan tumpukan email lengkap dengan mailbox IMAP, submission, filter sieve, dan penandatanganan DKIM (domainkeys identified mail). Anda mengaktifkannya per domain melalui bagian Email di dasbor. Tantangan utamanya adalah memastikan email terkirim, dan Cloudron bukan penyebab kesulitan tersebut.

  • Port outbound 25 diblokir oleh sebagian besar penyedia VPS untuk mengendalikan spam. Beberapa penyedia akan membukanya setelah menerima tiket dukungan. Uji dari server menggunakan nc -zv aspmx.l.google.com 25 (instal netcat-openbsd jika perintah tersebut tidak tersedia). Pelaporan port terbuka ditampilkan oleh succeeded, sedangkan port yang diblokir akan menggantung hingga mengalami timeout.
  • Record PTR (DNS terbalik) diatur oleh penyedia VPS, bukan oleh host DNS Anda. Record tersebut harus cocok dengan hostname email saat Anda mengirim langsung dari server. Smart host menghilangkan persyaratan PTR tersebut.
  • Record SPF, DKIM, dan DMARC dibuat untuk Anda pada backend DNS berbasis API. Pada backend Wildcard atau Manual, Anda harus menambahkannya secara manual. Record DKIM yang tidak ada membuat setiap pesan yang Anda tandatangani tidak dapat diverifikasi.

Konfigurasi yang paling sesuai untuk sebagian besar pengguna adalah menerima email di Cloudron dan mengirimkannya melalui relay seperti SendGrid, Postmark, Mailgun, atau Amazon SES yang dikonfigurasi pada tampilan Email. Relay tersebut harus mengizinkan pengiriman sebagai alamat apa pun pada domain Anda. Jika tidak, notifikasi aplikasi dari pengirim yang berbeda akan ditolak. Jika email adalah alasan utama Anda membeli server, jalankan server email khusus seperti Mailcow pada mesinnya sendiri dengan reputasi IP sendiri.

Jika Anda sama sekali tidak menggunakan Cloudron Email, blokir port 25, 465, 587, 993, dan 4190 pada firewall penyedia Anda. Lakukan pemblokiran tersebut di sana, bukan di server, karena Cloudron menulis aturan iptables sendiri dan mengharapkan untuk mengelolanya. Hal ini berbeda dengan VPS biasa, tempat Anda mengelola aturan ufw sendiri.

Konfigurasikan target pencadangan sebelum Anda membutuhkannya

Secara default, pencadangan menggunakan filesystem lokal di /var/backups, pada disk yang sama dengan komponen lainnya. Dokumentasi menyatakannya secara tegas: "Menyimpan backup pada disk fisik yang sama dengan server platform berbahaya." Satu disk yang gagal dapat menyebabkan aplikasi dan backup hilang bersamaan.

Buka Backups, lalu Backup Sites, dan arahkan pencadangan ke lokasi lain sejak hari pertama. Object storage yang kompatibel dengan S3 biasanya menjadi pilihan utama (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces, atau bucket MinIO pada server kedua). Target SSHFS, NFS, CIFS, dan filesystem biasa juga didukung.

Tiga pengaturan menentukan apakah backup tersebut benar-benar berguna:

  • Format. tgz menulis satu arsip terkompresi untuk setiap aplikasi dan mengunggah ulang seluruh arsip pada setiap proses. rsync hanya mengunggah file yang berubah, sehingga biayanya jauh lebih rendah untuk Nextcloud berukuran besar, tetapi memerlukan lebih banyak request ke API storage.
  • Enkripsi. Bersifat opsional dan menggunakan AES-256 untuk melindungi isi file serta nama file. Cloudron tidak menyimpan salinan password, sehingga jika password hilang, backup tidak dapat didekripsi oleh siapa pun, termasuk Anda. Simpan password tersebut di password manager yang di-host sendiri sebelum mengeklik save.
  • Retensi. Ditulis sebagai jumlah, misalnya 7 harian dan 4 mingguan. Retensi yang panjang pada object storage akan menambah tagihan setiap bulan. Pilih jumlah yang sanggup terus Anda bayar.

Selanjutnya, uji pemulihan. Install aplikasi kecil, pulihkan dari dashboard, lalu monitor hingga aplikasi kembali beserta datanya. Backup yang belum pernah dipulihkan siapa pun hanyalah perkiraan.

Batas paket gratis

Per Oktober 2026, paket gratis dibatasi hingga dua aplikasi yang terinstal. Fitur lainnya tetap tersedia: pembaruan aplikasi, backup per aplikasi, firewall, mail server, dan single sign-on. Aplikasi ketiga adalah batas yang mengharuskan Anda memiliki lisensi. Paket berbayar menghapus batas jumlah aplikasi, sedangkan paket yang lebih tinggi menambahkan grup dan peran pengguna, directory server, serta beberapa situs backup. Harga dapat berubah, jadi periksa halaman harga Cloudron, bukan angka yang tercantum dalam tutorial.

Satu lisensi berlaku untuk satu instalasi Cloudron. Jadi, biaya dua server kecil menjadi dua kali biaya satu server yang lebih besar. Struktur harga ini membuat sebagian besar pengguna memilih satu VPS yang lebih besar, meskipun hal tersebut bertentangan dengan saran umum untuk menyebarkan layanan ke beberapa mesin. Pertimbangkan hal ini saat menentukan ukuran server, karena memisahkan layanan di kemudian hari berarti membayar dua kali.

Jika terjadi masalah

Mulailah dengan pemeriksaan bawaan. Pemeriksaan ini menelusuri DNS, sertifikat, disk, memori, dan setiap service secara berurutan. Pemeriksaan ini juga menunjukkan pengujian yang gagal:

sudo cloudron-support --troubleshoot

Setelah itu, gunakan tool systemd standar (system dan service manager). systemctl status box melaporkan status service Cloudron itu sendiri, journalctl -u box -n 100 menampilkan log terbarunya, dan journalctl -u docker memeriksa container runtime yang mendasarinya. Semua masalah yang terjadi selama instalasi tercatat di /var/log/cloudron-setup.log.

Dashboard yang tidak dapat dimuat biasanya disebabkan oleh DNS atau firewall provider, bukan Cloudron. Jalankan dig +short my.example.com dari laptop Anda. Pastikan port 80 dan 443 terbuka pada firewall jaringan provider. Firewall ini terpisah dari aturan firewall milik server. Pada pemeriksaan installer tanggal October 13, 2026, proses kedua ditolak dengan Error: Cloudron is already installed. To reinstall, start afresh. Membangun ulang server adalah solusi yang tepat.

Saat Cloudron bukan pilihan yang tepat

Cloudron sesuai jika Anda menginginkan aplikasi, bukan infrastruktur. Cloudron kurang sesuai jika Anda ingin menjalankan container sendiri dengan cara Anda sendiri, karena Cloudron mengelola nginx, Docker, dan firewall, lalu dapat menimpa konfigurasi yang Anda buat di sana. Jika rencana Anda adalah menyimpan kumpulan file compose, Traefik di depan stack Docker Compose Anda sendiri memberi Anda TLS otomatis dan routing subdomain yang sama tanpa platform tambahan. Jika Anda belum menentukan pilihan, perbandingan Cloudron, CasaOS, dan Coolify menyajikan semuanya berdampingan, sedangkan daftar lebih luas tentang hal-hal yang dapat di-self-host merupakan titik awal yang lebih baik daripada panduan instalasi.

FAQ

Berapa RAM yang diperlukan Cloudron pada VPS?

Pemeriksaan installer pada 13 Oktober 2026 menolak berjalan dengan RAM di bawah 941 MB; dokumentasi saat ini meminta 2 GB, tetapi itu adalah batas minimum untuk platform tanpa aplikasi. Cloudron menjalankan Docker, nginx, layanan box miliknya sendiri, dan stack email. Cloudron juga menyediakan layanan database bersama saat aplikasi diterapkan. Sediakan 4 GB untuk dua aplikasi dan 16 GB untuk sekitar sepuluh aplikasi. Tambahkan file swap karena Cloudron memberikan swap tanpa batas kepada aplikasi. Server tanpa swap dapat mengalami tekanan memori yang menyebabkan service dimulai ulang.

Apakah Cloudron dapat diinstal pada Debian atau server yang sudah menjalankan Docker?

Keduanya tidak didukung. Dalam pemeriksaan installer pada 13 Oktober 2026, script berhenti pada release yang tidak didukung dengan Cloudron requires Ubuntu 22.04, 24.04, 26.04 dan menolak server yang sudah memiliki nginx, docker atau node. Dokumentasi instalasi saat ini mengharuskan image Ubuntu baru dan tidak mendukung Debian, Rocky, maupun Alpine. Mulai dari image Ubuntu baru pada VPS KVM.

Mengapa subdomain aplikasi saya gagal, sedangkan dashboard berfungsi?

Pada backend Wildcard, periksa record DNS wildcard. Setup membuat atau mengharuskan record A untuk my.example.com, sehingga dashboard dapat di-resolve, sedangkan wiki.example.com mengembalikan NXDOMAIN dan browser melaporkan bahwa situs tidak dapat ditemukan. Tambahkan record A untuk *.example.com yang mengarah ke IP server, lalu konfirmasi dengan dig +short wiki.example.com sebelum menginstal aplikasi.

Apakah saya harus menggunakan server email Cloudron?

Tidak. Anda dapat menonaktifkan email masuk dan mengirim email melalui relay eksternal seperti Postmark, Mailgun, atau Amazon SES. Ini merupakan pilihan yang lebih aman jika provider memblokir port outbound 25 atau alamat IP tersebut belum memiliki reputasi email. Jika Cloudron Email sama sekali tidak digunakan, tutup port 25, 465, 587, 993, dan 4190 pada firewall provider, bukan pada server.

Apa yang terjadi ketika saya mencapai batas dua aplikasi pada paket gratis?

Anda memerlukan subscription berbayar untuk menginstal aplikasi ketiga. Aplikasi yang sudah berjalan tidak terpengaruh. Aplikasi tersebut tetap diperbarui, tetap dicadangkan, dan tetap menggunakan sertifikatnya. Menambahkan subscription menghapus batas tersebut tanpa perlu menginstal ulang apa pun. Dengan demikian, paket gratis merupakan cara yang wajar untuk menguji platform pada domain nyata terlebih dahulu.

Apakah artikel ini bermanfaat?