Ketik setidaknya dua huruf untuk mencari di setiap halaman dokumentasi.

↑ ↓ untuk bernavigasi ↵ untuk membuka esc untuk menutup

Menggunakan rdev

Menghubungkan laptop Anda

Laptop Anda adalah editor dan peramban. Kode, layanan, dan agen tetap di server Anda.

Tailnet Anda sendiri

Laptop dan server Anda berkomunikasi melalui jaringan pribadi Tailscale milik akun Tailscale Anda. rdev tidak pernah bergabung ke dalamnya. Penginstal menghubungkan server Anda dengan kunci dari akun Anda, dan aplikasi laptop menghubungkan laptop Anda.

Sinkronisasi berkas

rdev menjaga berkas proyek Anda tersinkron antara laptop dan server, di kedua arah. Folder yang tidak perlu dikirim, seperti node_modules, vendor, dan hasil build, diabaikan sejak awal.

Anda memilih apa yang disinkronkan di panel, di Dasbor > server Anda > Pengaturan:

  • Sinkronkan ke laptop: matikan untuk bekerja sepenuhnya jarak jauh. Tidak ada yang disalin ke laptop; editor Anda membuka proyek lewat SSH (ssh rdev, VS Code atau Cursor Remote-SSH, PhpStorm Gateway). Situs dan .dev.test tetap berfungsi.
  • Proyek di laptop: hapus centang proyek untuk menyimpannya hanya di server. Salinan yang sudah ada di laptop Anda dibiarkan, jadi hapus saat tidak lagi dibutuhkan. Saat proyek disinkronkan lagi nanti, salinan laptop yang lebih lama dipindahkan ke ~/Code-rdev-old/ terlebih dahulu dan salinan server diturunkan.
  • Tidak pernah disinkronkan: pengecualian default, yang masing-masing dapat Anda matikan, ditambah pola Anda sendiri dalam sintaks yang mirip .gitignore.

Laptop menerapkan aturan baru dalam beberapa menit. Jalankan rdev laptop sync untuk menerapkannya segera.

Editor dan peramban

Gunakan editor yang sudah Anda kenal, seperti VS Code atau PhpStorm, pada berkas yang disinkronkan. Buka situs Anda di peramban favorit di https://<name>.dev.test; aplikasi laptop menyiapkan resolusi nama dan sertifikat tepercaya untuk alamat ini.

Berbagi berkas

Terminal di server Anda tidak dapat menempelkan berkas, jadi rdev memberi agen Anda folder bersama. Apa pun di ~/rdev-share di laptop Anda disalin ke ~/Share/<laptop name> di server dalam hitungan detik, bahkan saat sinkronisasi berkas nonaktif; setiap laptop memiliki folder sendiri di sana, sehingga beberapa laptop dapat berbagi bersamaan. Minta agen Anda "lihat tangkapan layar terakhir" atau "buka berkas yang baru saya kirim" dan agen membuka yang terbaru. Semua jenis berkas bisa: gambar, PDF, log, ekspor.

  • Send clipboard di aplikasi (juga di ikon bilah menu atau tray-nya) mengirim berkas yang Anda salin di Finder, Explorer, atau pengelola berkas Anda, atau jika tidak ada, gambar di papan klip Anda. Aplikasi menunggu sampai berkas tiba di server dan menaruh path servernya di papan klip Anda; tempelkan itu ke agen. Di terminal: rdev laptop share send, atau rdev laptop share send <files>.
  • Seret berkas ke jendela aplikasi untuk mengirimnya dengan cara yang sama.
  • Arah sebaliknya: berkas yang ditaruh agen Anda di ~/Share/<laptop name>/out di server tiba di ~/rdev-share/from-server di laptop Anda. Minta agen "taruh laporannya di out".
  • Save macOS screenshots here membuat Shift-Command-3, 4, dan 5 menyimpan ke ~/rdev-share (rdev laptop share macos). Aplikasi tangkapan layar seperti Shottr atau CleanShot juga dapat menyimpan ke sana.
  • Berkas dihapus setelah 7 hari di kedua sisi; ubah ini di Keep files for (days) di aplikasi atau dengan rdev laptop share keep <days> (0 menyimpannya). Berkas di folder keep tidak pernah dihapus.
  • Berkas di atas 500 MB tidak dikirim; pindahkan dengan scp atau rsync. Semuanya langsung ke server Anda dan tidak pernah melewati rdev.cloud. Matikan berbagi dengan sakelar di aplikasi atau rdev laptop share off.

Sebelum 1.2.0 ini adalah folder tangkapan layar: ~/rdev-shots pindah ke ~/rdev-share dan ~/Shots ke ~/Share dengan sendirinya, dan ~/Shots tetap berfungsi sebagai tautan.

Laptop yang didukung

Aplikasi laptop dan rdev laptop berjalan di macOS (Apple silicon dan Intel), Linux (x64 dan ARM64), dan Windows 10 dan 11 (x64 dan ARM64); dapatkan aplikasi di halaman unduhan. Di Linux Anda dapat memasangnya dengan satu perintah sebagai gantinya, yang mengambil .deb di Debian dan Ubuntu, .rpm di Fedora, dan AppImage di tempat lain, misalnya di Arch dan CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. AppImage disimpan di ~/.local/bin dan muncul di menu aplikasi Anda; aplikasi menjaga entri itu tetap menunjuk ke berkasnya jika Anda memindahkannya (1.4.4 atau yang lebih baru). Jika Anda mengunduh .deb sendiri, pasang dari /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, atau -x64); dari folder home Anda apt juga berfungsi tetapi mencatat bahwa pengguna sandbox-nya tidak dapat membaca berkas. Di Linux, rdev mengarahkan *.dev.test ke server Anda melalui systemd-resolved, yang digunakan sebagian besar distribusi. Jika dimatikan atau di-mask, seperti pada beberapa image mesin virtual, rdev laptop connect memberi tahu dan menunjukkan cara mengaktifkannya: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, lalu sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, dan hubungkan lagi. Ketika NetworkManager menyimpan /etc/resolv.conf sendiri di samping systemd-resolved yang sedang berjalan (Tailscale lalu melaporkan bahwa keduanya "wired together incorrectly"), kueri tidak pernah mencapai rute rdev; rdev laptop connect dan rdev laptop status memberi tahu hal ini (1.4.4 atau yang lebih baru), dan perintah ln -sf yang sama memperbaikinya. rdev menambahkan sertifikatnya ke sertifikat tepercaya sistem di Debian, Ubuntu, Fedora, openSUSE, Arch, dan CachyOS; sebelum 1.4.4, koneksi berhenti di titik itu pada Arch dan CachyOS.

Hubungkan langkah demi langkah

  1. Pasang Tailscale di laptop Anda dan masuk dengan akun Tailscale yang sama dengan yang digunakan server Anda. Di Linux Anda dapat melewati ini: jika Tailscale tidak ada, rdev laptop connect memasangnya dari repositori resmi Tailscale dan memulai proses masuk, yang Anda selesaikan di peramban.
  2. Pasang rdev di laptop Anda dan hubungkan. Jalankan ini di terminal sebagai diri Anda sendiri, dan masukkan kata sandi laptop Anda saat diminta; kata sandi diperlukan untuk memasang rdev, memercayai sertifikat, dan menyiapkan resolusi nama:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Perintah ini memasang perintah rdev dan menjalankan rdev laptop connect, yang menemukan server Anda di tailnet, menambahkan entri rdev ke konfigurasi SSH Anda, memercayai sertifikat lingkungan Anda, mengarahkan *.dev.test ke server Anda, dan mulai menyinkronkan folder ~/Code Anda dengan ~/Code di server.

Anda tidak perlu memasang hal lain terlebih dahulu. Jika alat sinkronisasi berkas tidak ada, rdev memasang salinan yang dipatok versinya dan diverifikasi checksum-nya di ~/.local/share/rdev/bin; yang sudah Anda miliki digunakan apa adanya. Di Linux perintah ini juga memasang alat papan klip yang digunakan untuk tangkapan layar (wl-clipboard, xclip) dan certutil, yang menaruh sertifikat di Chrome, dengan pengelola paket Anda, di bawah permintaan kata sandi yang sama. Jika Anda memberi server nama lain saat instalasi, tambahkan --server <name>; untuk menyinkronkan folder lain, tambahkan --code-dir <folder>. Jalankan rdev laptop connect lagi kapan pun Anda ingin mengulang penyiapan.

Sebelum meminta kata sandi, rdev laptop connect memeriksa folder yang akan disinkronkan. Perintah ini berhenti dan menyarankan --code-dir <folder> jika sesi sinkronisasi lain sudah menyinkronkan folder itu atau folder induknya (menyinkronkannya juga dengan rdev akan menyalin semuanya di antara tiga mesin); jalankan dengan --force atau pilih Tetap sinkronkan di aplikasi untuk tetap menyinkronkannya. Folder lebih dari 5 GB juga terhubung, dengan catatan bahwa sinkronisasi pertama butuh waktu (rdev 1.1.10 atau lebih baru; sebelumnya berhenti).

Di Mac yang sudah mengarahkan dev.test ke tempat lain, misalnya ke server pengembangan lain, rdev menyimpan pengaturan itu dan mengembalikannya saat Anda memutuskan atau menghapus instalasi.

Di Windows, perintah curl di atas tidak berlaku: pasang aplikasi dari halaman unduhan dan sambungkan dari sana. Mulai aplikasi laptop 1.4.2, aplikasi juga memasang perintah rdev di %USERPROFILE%\.local\share\rdev\bin dan menambahkan folder itu ke PATH Anda; buka terminal baru untuk menggunakannya. Tidak memerlukan hak administrator dan diperbarui bersama aplikasi.

Jika aplikasi terus menampilkan Check connection saat berkas disinkronkan, dan rdev laptop status menyebut *.dev.test resolves to …, not the server, periksa halaman DNS di konsol admin Tailscale. Entri split DNS untuk dev.test yang mengarah ke mesin lain, seperti server lama, didahulukan daripada pengaturan rdev di Windows. Hapus entri itu, atau arahkan ke server Anda.

Periksa koneksi kapan saja dengan rdev laptop status. rdev laptop disconnect menghentikan sinkronisasi dan menghapus pengaturan; berkas Anda tetap di kedua sisi.

Hapus rdev dari laptop Anda

rdev laptop uninstall

Perintah ini memutuskan koneksi, berhenti memercayai sertifikat lingkungan Anda, dan menghapus perintah rdev, pengaturannya, dan alat yang dipasangnya. Folder yang disinkronkan dan ~/rdev-share tetap ada. Alat sinkronisasi yang dipasang rdev juga tetap ada selama sesi sinkronisasi lain masih menggunakannya. Perintah ini meminta kata sandi laptop Anda sekali dan memerlukan rdev 0.2.0-beta.21 atau yang lebih baru.

Laptop Anda harus dapat masuk ke server: penginstal menyalin kunci SSH yang dapat masuk ke server saat Anda memasang. Untuk menambahkan laptop lain, tambahkan kunci publiknya di halaman server Anda di panel pada Kunci SSH (satu per baris, sehingga beberapa komputer sekaligus; saat menambahkan satu, Anda dapat memberinya nama seperti Laptop kantor, jika tidak nama di akhir kunci ditampilkan); server mengizinkannya masuk dalam hitungan detik. Itu memerlukan rdev 0.2.0-beta.33 atau yang lebih baru; sebelumnya, letakkan kunci di /opt/rdev/home/.ssh/authorized_keys di server. Jika rdev laptop connect menyatakan tidak dapat masuk, inilah yang kurang.

Setelah terhubung, buka terminal di server dengan ssh rdev dan jalankan agen Anda di sana; buka situs Anda di peramban di https://<folder>.dev.test. rdev open <proyek> membuka terminal di server langsung di folder proyek, dalam sesi persisten Anda; tanpa nama, perintah ini menampilkan daftar proyek (rdev 1.1.11 atau lebih baru).

Aplikasi Mac

Lebih suka mengeklik daripada mengetik? Unduh aplikasi rdev untuk Mac (Apple silicon dan Intel, ditandatangani dan dinotarisasi oleh Apple), seret ke Applications, dan buka. Aplikasi menunjukkan apakah laptop Anda terhubung, menghubungkan dan memutuskan dengan satu tombol, dan membuka terminal di server Anda. Aplikasi melakukan penyiapan yang sama seperti rdev laptop connect, jadi Anda memerlukan Tailscale (langkah 1) tetapi bukan perintahnya; aplikasi memasang alat sinkronisasi sendiri. Sebelum menghubungkan, Anda dapat mengubah folder tempat proyek Anda disinkronkan (~/Code secara default), versi aplikasi dari --code-dir.

Saat pertama dibuka, aplikasi memandu penyiapan langkah demi langkah, dan tab-tabnya baru terbuka setelah semua langkah berhasil: masuk dengan akun rdev, periksa Tailscale sudah terpasang dan masuk, pilih server dari akun Anda, izinkan laptop ini (aplikasi menambahkan kunci SSH-nya ke server untuk Anda, dan membuatnya jika belum ada), pilih folder sinkronisasi proyek dengan Telusuri…, lalu hubungkan. Nanti, Ganti server di tab Sites menyiapkan ulang laptop untuk server lain. Jika server laptop sudah tidak ada, tidak terjangkau, atau tidak lagi di akun Anda, aplikasi memberi tahu dan menawarkan Siapkan ulang. Dalam kedua kasus file Anda tetap di tempatnya. Jika perintah rdev lebih lama dari aplikasinya, About menampilkan Jalankan di Terminal, yang membuka terminal dengan perintah pembaruan.

Aplikasi memiliki tujuh tab:

  • Sites: proyek Anda sebagai tautan https://<name>.dev.test, terminal di server, dan berkas yang Anda bagikan. Setiap situs punya Open in Terminal, yang membuka terminal di folder proyek itu di server. Tab Sites juga memiliki tombol Mail dan Dumps yang membuka halaman email dan dump yang tertangkap. Ada juga tombol Web terminal yang membuka terminal web. Ada juga tombol Errors yang membuka pelacakan galat.
  • Sync: pengaturan yang sama seperti di panel Anda (sinkronisasi aktif atau nonaktif, proyek di laptop ini, pengecualian). Menyimpan menerapkannya di laptop ini segera.
  • Env: baca dan ubah .env proyek di server. Aplikasi bekerja melalui koneksi SSH, sehingga menampilkan nilai saat ini, dan nilai tidak pernah melewati rdev.cloud.
  • Gotify: jika notifikasi Anda dikirim ke server Gotify, aplikasi mendengarkannya dan menampilkan setiap pesan sebagai notifikasi desktop dengan suara. Masukkan alamat server dan token klien (Gotify Clients); tambahkan token aplikasi (Gotify Apps) untuk mengirim pesan uji. Token tetap di laptop ini.
  • Integrations: Akses Git server Anda: kuncinya, akun GitHub, GitLab, Bitbucket, dan lainnya sebanyak yang Anda mau (masing-masing dengan kunci SSH atau token sendiri), host yang menunggu dipercaya, dan uji akses. Token dikirim ke server lewat SSH, tidak pernah melalui rdev.cloud.
  • Settings: aplikasi terminal yang dibuka oleh Terminal on the server (yang terpasang mana pun, seperti Terminal, iTerm2, atau Warp; dipertahankan sampai Anda mengubahnya), ikon bilah menu (monokrom, yang mengikuti bilah menu terang atau gelap, atau ikon aplikasi berwarna), sinkronisasi tangkapan layar, dan akun Anda: pilih Sign in with rdev.cloud, konfirmasi kata sandi Anda di peramban, periksa bahwa kode yang ditampilkan sama, dan setujui. Aplikasi yang sudah masuk dicantumkan, dan dapat diputuskan, di Pengaturan > Aplikasi terhubung pada panel Anda.
  • About: versi aplikasi dan perintah rdev, serta aplikasi terbaru di rdev.cloud.

Terminal bawaan

Terminal on the server membuka terminal bawaan rdev: jendela sendiri yang bisa diubah ukurannya, dimaksimalkan, atau dibuat layar penuh, dan terbuka lagi dengan ukuran terakhirnya. Terminal ini masuk dengan ssh rdev dan bergabung ke sesi persisten server Anda, jadi menutup jendela atau kehilangan jaringan tidak pernah menghentikan agen; saat koneksi terputus, ia menyambung ulang sendiri dan Anda kembali ke tempat terakhir.

  • Salin dan tempel: Cmd-C dan Cmd-V di macOS, Ctrl-Shift-C dan Ctrl-Shift-V di Linux dan Windows. Teks yang disalin di server, misalnya di vim, masuk ke papan klip laptop Anda. Dengan tangkapan layar aktif, menempelkan gambar mengirimnya ke server dan menempelkan jalurnya, siap untuk agen Anda.
  • Shift-Enter memulai baris baru di prompt Claude Code.
  • Cari dengan Cmd-F (Ctrl-Shift-F di Linux dan Windows); ubah ukuran teks dengan Cmd dan +, − atau 0 (Ctrl di Linux dan Windows).
  • Tautan terbuka di peramban Anda, termasuk situs https://<nama>.dev.test. Saat jendela di latar belakang dan terminal membunyikan bel, misalnya ketika agen membutuhkan Anda, Anda mendapat notifikasi.
  • Open in an external terminal membuka sesi yang sama di aplikasi terminal: tombol di samping Terminal on the server, menu ikon bilah menu, atau Cmd-Shift-O (Ctrl-Shift-O) di terminal bawaan. Untuk menjadikan aplikasi terminal sebagai bawaan, pilih di Settings. Aplikasi yang dipakai dipilih di External terminal pada Settings; awalnya aplikasi terminal yang Anda pilih sebelumnya, atau Terminal di Mac.

Aplikasi memeriksa versi yang lebih baru saat dimulai, setiap enam jam, dan saat Anda membuka About. Saat ada, sebuah bar di atas tab memberitahukannya: pilih Update, dan aplikasi mengunduhnya, memeriksa tanda tangannya, memasangnya, dan memulai ulang (di Linux .deb dan .rpm meminta kata sandi Anda; di Windows penginstal berjalan sendiri). Memperbarui di aplikasi memerlukan 0.2.0-beta.34 atau yang lebih baru; pasang versi yang lebih lama secara manual sekali. Perintah rdev di laptop Anda diperbarui terpisah: jalankan lagi perintah instalasi, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Di Windows perintah ini datang bersama aplikasi dan diperbarui bersamanya. Saat perintah lebih lama dari aplikasi, About menampilkan perintah itu dengan tombol salin.

Menutup jendela menjaga rdev di bilah menu dan mengeluarkannya dari Dock dan Cmd-Tab; Quit di menu ikon bilah menu, atau Cmd-Q, menutupnya.

Di Settings (aplikasi laptop 1.4.3 atau yang lebih baru), Open at login menjalankan rdev di latar belakang saat Anda masuk, langsung ke bilah menu atau tray, dan Keep running when the window is closed (aktif secara default) menentukan apakah menutup jendela membuatnya tetap berjalan di sana atau menutupnya. Saat aktif, sinkronisasi berkas dan notifikasi tetap berfungsi meskipun jendela ditutup. GNOME hanya menampilkan ikon tray dengan ekstensi AppIndicator (Ubuntu sudah menyertakannya); tanpa ekstensi itu, jendela yang ditutup tidak menyisakan ikon untuk diklik, jadi buka rdev lagi dari menu aplikasi Anda. Aplikasi memperingatkan hal ini di Settings (aplikasi laptop 1.4.4 atau yang lebih baru). Membuka saat masuk tidak memerlukan hak administrator: rdev menambahkan item login hanya untuk pengguna Anda (launch agent di macOS, entri autostart di Linux, entri Run di registri pengguna Anda di Windows).

Aplikasi juga menerapkan aturan sinkronisasi panel setiap lima menit selama berjalan.

Firefox menyimpan daftar sertifikatnya sendiri. Di Linux, rdev menambahkan sertifikatnya ke Chrome dan ke setiap profil Firefox yang ditemukannya, termasuk Firefox snap yang disertakan Ubuntu dan yang Flatpak (rdev 0.2.0-beta.34 atau yang lebih baru); mulai ulang Firefox setelahnya. Untuk profil Firefox yang dibuat kemudian, atau di macOS dan Windows, impor ~/.config/rdev/ca.pem di Settings > Privacy & Security > Certificates.