# Erste Schritte

## Voraussetzungen installieren

Installiere für die standardmäßige lokale Tunneleinrichtung diese Tools auf deinem Computer:

### Node.js 20+

Lade es von [nodejs.org](https://nodejs.org) herunter oder verwende deinen Paketmanager.

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

### tmux

Der Terminal-Multiplexer, der Termbridge-Sitzungen ermöglicht.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Erstellt den sicheren Tunnel zu deinem Terminal (im direkten Sandbox-Modus nicht erforderlich).

```bash
# macOS
brew install cloudflared

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

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


## Termbridge ausführen

```bash
npx termbridge
```

Die Ausgabe sieht etwa so aus:

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

> **Hinweis**
> Das `trycloudflare.com` URL ist ein temporärer Tunnel, für den kein Konto erforderlich ist. Wenn du Termbridge häufig verwendest,
> richte ein Token für einen benannten Cloudflare-Tunnel ein, um Ratenbegrenzungen zu vermeiden.


## Mit deinem Smartphone verbinden

1. Öffne die Kamera deines Smartphones
2. Richte sie auf den QR-Code
3. Tippe auf den angezeigten Link
4. Dein Terminal wird im Browser geladen

Das war's – du bist verbunden!

## Was ist gerade passiert?

1. Termbridge hat einen lokalen Server auf deinem Rechner gestartet
2. Für dein Terminal wurde eine tmux-Sitzung erstellt
3. Cloudflare hat einen sicheren Tunnel eingerichtet (den `trycloudflare.com` URL)
4. Der QR-Code enthält ein einmaliges Token für den sicheren Zugriff. Es funktioniert nur einmal und läuft 90 Sekunden nach dem Start ab. Scanne den Code daher zeitnah. Ist er abgelaufen, starte Termbridge neu, um einen neuen zu erhalten
5. Beim Scannen hast du ein Sitzungscookie erhalten und dich verbunden

## Probier es aus

Probiere nach dem Verbinden ein paar Befehle aus:

```bash
# See system info
htop

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

# Run any CLI tool
```

Das Terminal unterstützt alle Farben, TUIs und Tasten, die du erwartest.

## Weiterlaufen lassen

Termbridge muss laufen, damit die Verbindung funktioniert. Wenn du fertig bist:

- Drücke `Ctrl+C` im Terminal, in dem Termbridge läuft
- Der Tunnel wird geschlossen und die Verbindung beendet
- Deine tmux-Sitzung bleibt aktiv (sofern du nicht `--kill-on-exit` verwendet hast)

## Verhalten der ersten Sitzung

- Termbridge erstellt eine tmux-Sitzung (der Standardname leitet sich vom Port ab)
- Das erste Terminal in der Liste wird automatisch geladen
- Beim Start kannst du mehrere Sitzungen erstellen, indem du `TERMBRIDGE_SESSIONS=2` festlegst

## Vorhandene tmux-Sitzung verwenden

Wenn du `--session <name>` angibst und diese Sitzung bereits besteht, verbindet sich Termbridge mit ihr, statt eine neue zu erstellen. Das ist praktisch, wenn du bereits gestartete, länger laufende Prozesse überwachen möchtest.

## Nächste Schritte

### [Steuerung auf Mobilgeräten](https://termbridge.inline0.dev/de/docs/usage/mobile-controls)

Tipps zur Verwendung von Termbridge auf Smartphones und Tablets

### [Mehrere Terminals](https://termbridge.inline0.dev/de/docs/usage/multiple-terminals)

Führe mehrere Sitzungen aus und wechsle zwischen ihnen

### [Vorschau des Dev-Servers](https://termbridge.inline0.dev/de/docs/usage/dev-server-preview)

Zeige deine Vite-App neben dem Terminal in der Vorschau an

### [CLI-Referenz](https://termbridge.inline0.dev/de/docs/cli)

Alle verfügbaren Flags und Optionen ansehen