# Pocketmux Docs

> Documentation for pmux, the open-source CLI that provides secure remote tmux access from a phone, and the Pocketmux mobile app (iOS and Android). pmux runs on your computer as a transparent tmux proxy; the app connects directly to it over an end-to-end encrypted, peer-to-peer WebRTC DataChannel. The signaling server is zero-knowledge — it never sees terminal content, session metadata, or activity.

Key facts:
- The pmux CLI, agent, signaling server, and wire protocol are free and open source (MIT): https://github.com/ShiftinBits
- The Pocketmux mobile app is a paid companion: no accounts, no ads, no tracking
- Authentication uses device-bound Ed25519 keys — no passwords, OAuth, or email
- Device pairing uses a one-time QR code and X25519 key exchange; the pairing secret never touches the server
- Terminal data is encrypted end-to-end with DTLS; an encrypted TURN relay is used only as fallback
- Availability: United States and Canada (App Store and Google Play)
- Publisher: ShiftinBits Inc. (https://shiftinbits.com)

## Pages

- [Introduction](https://docs.pmux.io/): what Pocketmux is, how it works, key principles
- [Installation](https://docs.pmux.io/getting-started/installation/): installing the pmux CLI via Homebrew or binary download, verification, troubleshooting
- [Initialization](https://docs.pmux.io/getting-started/initialization/): running pmux init, identity generation, secret storage
- [Pairing](https://docs.pmux.io/getting-started/pairing/): pairing a phone with a host via QR code, re-pairing, troubleshooting
- [CLI Reference](https://docs.pmux.io/reference/cli/): every pmux command, tmux passthrough, socket isolation
- [Configuration](https://docs.pmux.io/reference/configuration/): full config schema, precedence, environment variables, file paths
- [Technical Design](https://docs.pmux.io/architecture/design/): system architecture, connection flow, security model, wire protocol

## Related

- [Product homepage](https://pmux.io/): overview, pricing, comparison with SSH clients
- [Security](https://pmux.io/security): full security model and vulnerability disclosure
- [Privacy Policy](https://pmux.io/privacy): what the server stores and why