Promo peluncuran90 hari pertama BYOC gratis untuk satu server — hubungkan server yang sudah kamu sewa. Sampai 15 Januari 2027.Ambil promonya →

Menyiapkan Server BYOC

Langkah demi langkah: siapkan server, daftarkan, jalankan perintah instalasi, dan pastikan siap menerima deploy.

Panduan ini membantu Anda mengubah server baru menjadi tempat yang bisa menjadi tujuan deploy Raklane. Biasanya hanya butuh sekitar lima menit. Jika belum, baca dulu BYOC: Gambaran Umum & Cara Kerja — halaman itu menjelaskan apa yang dipasang dan mengapa.

Sebelum mulai

Persyaratan server

  • Sistem operasi: Ubuntu 20.04+ atau Debian 11+.
  • Akses: root, atau user dengan sudo, lewat SSH.
  • Alamat IPv4 publik milik server itu sendiri — dibutuhkan untuk HTTPS otomatis dan URL bawaan gratis. (Server di jaringan privat tetap berfungsi, tetapi hanya lewat HTTP biasa dan hanya dari dalam jaringan tersebut.) Paket VPS yang memakai satu IP publik bersama untuk banyak server tidak didukung — lihat VPS dengan IP bersama tidak didukung.
  • Resource: sesuai kebutuhan aplikasi Anda. Build dilakukan di Raklane, bukan di server Anda, jadi tidak perlu ruang lebih untuk kompilasi. Server 1 vCPU / 1 GB sudah cukup untuk mencoba.
  • Ruang disk untuk container image dan data database.

Docker tidak perlu dipasang lebih dulu — perintah instalasi akan memasangnya jika belum ada.

Persyaratan jaringan

Masuk (dari internet publik ke server Anda):

PortAlasan
80HTTPS otomatis: certificate authority memverifikasi domain Anda lewat port 80. Request HTTP biasa dialihkan ke HTTPS.
443Tempat aplikasi Anda disajikan lewat HTTPS.
22Akses SSH Anda sendiri. Raklane tidak pernah memakainya.

Keluar (dari server Anda ke Raklane) — biasanya sudah diizinkan secara bawaan:

  • Raklane lewat HTTPS (untuk mengunduh installer dan mendaftar).
  • Port koneksi Node Agent di Raklane (8443 secara bawaan).
  • Image registry Raklane lewat HTTPS (untuk menarik image aplikasi).

Kesalahan penyiapan yang paling umum: banyak penyedia cloud memasang firewall di depan server Anda (AWS Security Groups, aturan firewall GCP, cloud firewall DigitalOcean/Hetzner/Vultr, dan sebagainya), terpisah dari firewall di dalam OS. Perintah instalasi membuka port 80/443 di firewall OS (ufw), tetapi tidak bisa menyentuh firewall penyedia cloud Anda. Buka juga 80 dan 443 di sana, ke 0.0.0.0/0.

VPS dengan IP bersama tidak didukung

Sebagian penyedia VPS murah tidak memberi setiap server IP publik sendiri. Banyak server berbagi satu IP publik, dan server Anda hanya mendapat beberapa port yang di-forward — misalnya SSH di port 20022 pada IP bersama yang di-forward ke port 22 di server Anda. Raklane tidak bisa menyajikan aplikasi di server seperti ini: port 80 dan 443 di IP bersama itu milik penyedia, bukan milik server Anda, sehingga pengunjung maupun certificate authority tidak bisa menjangkaunya. Server tetap bisa mendaftar dan bahkan tampil Healthy, tetapi aplikasi Anda tidak akan terbuka.

Tanda-tanda umumnya: dashboard penyedia Anda punya halaman Port Forwarding (sering dengan jumlah port terbatas), atau Anda masuk SSH lewat port selain 22.

Cara memeriksa server Anda

Jalankan perintah berikut di server, sebelum memasang Raklane:

  1. Lihat alamat milik server itu sendiri:

    ip -4 addr show scope global
    
  2. Cari IP publik yang terlihat dari internet:

    curl -4 https://api.ipify.org
    
  3. Bandingkan keduanya. Jika IP dari langkah 2 muncul di langkah 1, server punya IP publik sendiri — Anda siap melanjutkan.

  4. Jika tidak muncul (langkah 1 hanya menampilkan alamat privat seperti 10.x.x.x, 172.16–31.x.x, atau 192.168.x.x), server berada di balik NAT. Ini normal di AWS, Google Cloud, Azure, dan lainnya, di mana IP publiknya tetap khusus milik Anda. Untuk mengetahui jenis yang Anda pakai, periksa apakah port 80 di IP publik sampai ke server ini. Jalankan web server sementara di server:

    sudo python3 -m http.server 80
    

    Lalu, dari komputer Anda sendiri (bukan dari server), buka http://<IP publik dari langkah 2>/ di browser atau jalankan curl http://<IP publik dari langkah 2>/.

    • Anda melihat daftar direktori, dan terminal server mencatat request-nya — port 80 sampai ke server Anda. IP publiknya milik Anda; Anda siap melanjutkan.
    • Timeout, atau muncul halaman lain — port 80 tidak sampai ke server Anda. Pastikan dulu port 80 terbuka di firewall penyedia Anda (lihat di atas). Jika sudah, dan penyedia Anda hanya menawarkan port forwarding, berarti itu VPS dengan IP bersama.

    Tekan Ctrl+C di server untuk menghentikan web server sementara.

Jika Anda memakai paket dengan IP bersama, minta IPv4 publik khusus (dedicated) ke penyedia Anda (banyak yang menjualnya sebagai add-on), atau pilih paket yang sudah termasuk IP publik sendiri.

Yang perlu Anda tentukan

  • Nama server — sekadar label untuk Anda di dashboard (misalnya prod-vps-1).
  • Label provider — AWS, Google Cloud, Azure, DigitalOcean, Hetzner, Bare metal / on-prem, atau Other. Ini hanya untuk referensi Anda; Raklane tidak pernah terhubung ke API penyedia Anda.
  • External host (opsional) — hanya jika server Anda berada di balik NAT atau jaringan privat dengan IP publik khusus miliknya sendiri, dan IP publik atau hostname tersebut berbeda dari alamat yang dipakainya untuk terhubung ke Raklane. Biarkan kosong jika ragu; Anda bisa mengaturnya nanti.

Langkah 1: Daftarkan server

  1. Di dashboard, buka Clusters.
  2. Klik Add server (atau Add your first server).
  3. Isi Server name, pilih Provider, dan opsional External host.
  4. Klik Continue.

Jika biaya pengelolaan BYOC berlaku, dialog ini menampilkan perkiraan tambahan biaya bulanan untuk server biasa sebelum Anda melanjutkan. Lihat Tagihan BYOC.

Server kini terdaftar dengan status Pending — Raklane sedang menunggunya mendaftar.

Langkah 2: Jalankan perintah instalasi di server Anda

Layar berikutnya menampilkan perintah instalasi beserta token pendaftaran di dalamnya. Salin perintahnya, SSH ke server itu sendiri (bukan komputer Anda), lalu jalankan:

curl -fsSL https://api.raklane.com/install/agent-install.sh \
  | sudo bash -s -- --token=YOUR_ENROLLMENT_TOKEN --control-plane=https://api.raklane.com

Gunakan perintah persis dari dashboard — URL Raklane dan token Anda sudah terisi di sana.

Perintah ini:

  1. Memasang Docker, jika belum terpasang.
  2. Memasang Caddy, yang menyajikan aplikasi Anda lewat HTTPS.
  3. Memasang Raklane Node Agent sebagai layanan systemd bernama raklane-agent, sehingga menyala saat boot dan di-restart jika crash.
  4. Membuka port 80/443 di ufw, jika ufw aktif.
  5. Mendaftarkan agent dengan token sekali pakai Anda. Agent membuat private key-nya sendiri di server, menerima sertifikat dari Raklane, lalu membuka koneksi terenkripsinya.

Aman dijalankan ulang jika gagal di tengah jalan.

Perlakukan token seperti kata sandi sampai dipakai. Siapa pun yang memilikinya bisa mendaftarkan server sebagai cluster ini — tetapi hanya sekali, dan token berhenti berlaku begitu server Anda mendaftar.

Terlanjur menutup dialog?

Tidak apa-apa. Server tetap terdaftar dengan status Pending. Dari halaman Clusters, buka menu server dan pilih Regenerate token untuk mendapat perintah instalasi baru. Token sebelumnya langsung tidak berlaku.

Flag instalasi opsional

Biasanya Anda tidak membutuhkannya — perintah dari dashboard sudah lengkap. Flag ini untuk penyiapan yang tidak biasa:

FlagKapan digunakan
--grpc-addr=HOST:PORTAlamat koneksi agent tidak bisa diturunkan dari URL control plane (misalnya Anda mendaftar ke alamat IP). Support Raklane akan memberi tahu jika ini dibutuhkan.
--insecure-registry=HOST:PORTImage registry disajikan lewat HTTP biasa (hanya untuk penyiapan development). Bisa diulang.

Langkah 3: Pastikan server sehat

Kembali ke dashboard, klik I've run the command, lalu Check now. Raklane menjalankan tiga pemeriksaan:

PemeriksaanYang dibuktikan
RegistrationServer sudah menyelesaikan pendaftaran dengan tokennya.
HeartbeatAgent sedang terhubung dan rutin melapor.
Docker ConnectivityRaklane benar-benar bisa menjangkau Docker di server Anda lewat agent — artinya deploy sungguhan akan berhasil saat ini.

Jika ketiganya lolos, Anda akan melihat Healthy — this server is ready for deploys. Kartu server di halaman Clusters juga berubah menjadi Healthy, biasanya beberapa detik setelah instalasi selesai.

Jika ada pemeriksaan yang gagal, lihat Pemecahan Masalah BYOC. Anda bisa menjalankan pemeriksaan yang sama kapan saja lewat Check connection di menu server.

Langkah 4: Deploy sesuatu

Server Anda sudah siap. Pilih sebagai tempat aplikasi berjalan:

  • Aplikasi baru: di langkah terakhir (Review) wizard pembuatan aplikasi, pilih BYOC lalu pilih server Anda.
  • Aplikasi yang sudah ada: buka Settings → Deployment location aplikasi, pilih BYOC, pilih server Anda, lalu klik Move deployment.

Aplikasi Anda live di URL bawaannya (seperti https://your-app.203.0.113.10.byoc.raklane.com, memakai domain BYOC Raklane) begitu deploy berstatus active. Lihat Menjalankan Aplikasi & Database di BYOC untuk domain kustom, database, dan lainnya.

Isi server Anda sekarang

Sebagai referensi, instalasi meninggalkan hal-hal berikut di server Anda:

ApaDi mana
Layanan Node Agentsystemctl status raklane-agent
Log agentsudo journalctl -u raklane-agent -f
Pengaturan agent/etc/default/raklane-agent — lihat Konfigurasi Agent BYOC
Identitas agent (sertifikat, key)/etc/raklane-agent/ — jaga kerahasiaannya
Data database self-hosted/var/lib/raklane-agent/
Container aplikasi Andasudo docker ps

Untuk menyesuaikan agent — tingkat detail log, lokasi data database, pembaruan otomatis, dan lainnya — lihat Konfigurasi Agent BYOC.

Anda tetap punya akses root penuh. Anda bisa memeriksa apa pun, memasang alat monitoring, atau menerapkan pembaruan OS seperti biasa. Hindari menghentikan atau menghapus container yang dikelola Raklane secara manual — Raklane akan mendeteksinya dan menyalakannya kembali, dan status di dashboard akan membingungkan. Jeda atau hapus aplikasi dari dashboard saja.