# Memulai

## Instal prasyarat

Untuk menyiapkan tunnel lokal default, instal alat berikut di komputer Anda:

### Node.js 20+

Unduh dari [nodejs.org](https://nodejs.org) atau gunakan pengelola paket Anda.

```bash
# Check if installed
node --version
```

### tmux

Multiplexer terminal yang mendukung sesi Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Membuat tunnel aman ke terminal Anda (tidak diperlukan untuk mode langsung sandbox).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[Unduh cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Jalankan Termbridge

```bash
npx termbridge
```

Anda akan melihat keluaran seperti ini:

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **Catatan**
> `trycloudflare.com` URL adalah tunnel cepat tanpa akun. Jika Anda sering menggunakan Termbridge,
> siapkan token tunnel Cloudflare bernama agar terhindar dari batas laju.


## Sambungkan dari ponsel

1. Buka kamera ponsel Anda
2. Arahkan ke kode QR
3. Ketuk tautan yang muncul
4. Terminal Anda akan dimuat di browser

Selesai - Anda sudah terhubung!

## Apa yang baru saja terjadi?

1. Termbridge memulai server lokal di komputer Anda
2. tmux membuat sesi untuk terminal Anda
3. Cloudflare membuat tunnel aman (`trycloudflare.com` URL)
4. Kode QR berisi token sekali pakai untuk akses aman. Token ini hanya berlaku sekali dan kedaluwarsa 90 detik setelah mulai, jadi segera pindai; jika sudah kedaluwarsa, mulai ulang Termbridge untuk mendapat kode baru
5. Setelah memindainya, Anda mendapatkan cookie sesi dan terhubung

## Coba sekarang

Setelah terhubung, coba beberapa perintah:

```bash
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool
```

Terminal mendukung warna penuh, TUI, dan semua tombol yang Anda harapkan.

## Biarkan tetap berjalan

Termbridge harus tetap berjalan agar koneksi berfungsi. Setelah selesai:

- Tekan `Ctrl+C` di terminal tempat Termbridge berjalan
- Tunnel ditutup dan koneksi berakhir
- Sesi tmux Anda tetap aktif (kecuali jika Anda menggunakan `--kill-on-exit`)

## Perilaku sesi pertama

- Termbridge membuat sesi tmux (nama default diambil dari port)
- Terminal pertama dalam daftar dimuat secara otomatis
- Anda dapat membuat beberapa sesi saat mulai dengan menetapkan `TERMBRIDGE_SESSIONS=2`

## Menggunakan sesi tmux yang sudah ada

Jika Anda memberikan `--session <name>` dan sesi tersebut sudah ada, Termbridge akan menyambungkannya alih-alih membuat sesi baru. Ini berguna untuk memantau proses berjalan lama yang telah Anda mulai.

## Langkah berikutnya

### [Kontrol Seluler](https://termbridge.inline0.dev/id/docs/usage/mobile-controls)

Tips menggunakan Termbridge di ponsel dan tablet

### [Beberapa Terminal](https://termbridge.inline0.dev/id/docs/usage/multiple-terminals)

Jalankan beberapa sesi dan berpindah di antaranya

### [Pratinjau Server Dev](https://termbridge.inline0.dev/id/docs/usage/dev-server-preview)

Pratinjau aplikasi Vite Anda di samping terminal

### [ReferensiCLI](https://termbridge.inline0.dev/id/docs/cli)

Lihat semua tanda dan opsi yang tersedia