9Remote — Terminal in Your Pocket

Want to code from bed? Fix bugs while having coffee? Deploy while on vacation?

Your Mac/Linux/Windows terminal, remote desktop, and file explorer — accessible from any phone or browser, anywhere, instantly.

🚀 Quick Start • 📊 Comparison • 💡 Features • 🌐 Website • 📖 Docs • 💬 Facebook

🇺🇸 English • 🇻🇳 Tiếng Việt

🚧 Development Status

9Remote is currently in active development.

The source code is not open-source yet. If this project gets enough ⭐ support from the community, we will fully open-source it so everyone can contribute and self-host.

⭐ Star this repo to help us reach the open-source milestone!

🤔 Why 9Remote?

Remote access today is painful:

• ❌ SSH is a hassle — firewall rules, port forwarding, SSH keys, IP whitelisting
• ❌ VPN is overkill — complex setup just to check a terminal
• ❌ ngrok / tunnels expire — lose connection, restart everything
• ❌ TeamViewer is slow — high latency, desktop-only, paid for commercial use
• ❌ Chrome Remote Desktop — no terminal, no file explorer, no mobile
• ❌ Termius — SSH-only, no remote desktop, no browser access

9Remote solves all of it:

• ✅ One command — install, scan QR, done in 30 seconds
• ✅ Auto tunnel — Cloudflare tunnel starts automatically, no port forwarding
• ✅ All-in-one — terminal + remote desktop + file explorer + code editor in one app
• ✅ Works on phone — full workspace from your browser, under 50ms latency
• ✅ Persistent sessions — PTY daemon survives server restarts
• ✅ Pair Device security — only approved devices can connect, zero signup friction

⚡ Quick Start

Install globally:

npm install -g 9remote
9remote

🎉 Scan the QR code on your phone → pair your device → you're in.

That's it! No config, no firewall rules, no signup.

Ready in 30 seconds. Works on macOS, Linux, and Windows.

📊 9Remote vs Other Remote Solutions

🏆 9Remote: All-in-one solution with 16/16 features.

✨ Key Features

📱 Available Platforms

🎯 Use Cases

Case 1: "Code from bed"

Problem: It's 11 PM, you remember a bug but laptop is in another room.

Solution:

1. Open 9remote app on phone
2. Scan QR (or use saved session)
3. Open terminal → fix bug → git push
4. Sleep well 😴

Case 2: "Fix bugs at a cafe"

Problem: Production is down. You only have your phone and a bad café Wi-Fi.

Solution:

1. Connect to your home/office Mac via 9remote
2. Tail logs in terminal
3. Edit config in built-in editor
4. Deploy → crisis averted

Case 3: "Deploy while on vacation"

Problem: Client needs a hotfix. You're on the beach.

Solution:

1. Phone → 9remote → your dev machine
2. git pull → build → deploy
3. Back to the beach in 5 minutes 🏖️

Case 4: "On-call engineer"

Problem: PagerDuty alert at 3 AM. Don't want to power on laptop.

Solution:

1. Push notification → tap → 9remote opens
2. Terminal + remote desktop ready
3. Diagnose + restart service from bed
4. Resolve incident without getting up

📖 Setup Guide

Option 1 — NPM (recommended)

npm install -g 9remote
9remote

Option 2 — Desktop App

Download from 9remote.cc/download — native app with system tray integration, auto-start on boot, and background mode.

Option 3 — Mobile App

• iOS: App Store → "9Remote"
• Android: Google Play → "9Remote"

On first run, 9Remote generates two keys:

• Permanent Key — stored locally, tied to your machine ID, used for trusted devices
• One-Time Key — 30-minute temporary key, used for the QR code shown in terminal

Connect from phone:

1. Run 9remote on your Mac/Linux/Windows machine
2. A QR code appears in the terminal
3. Open 9Remote app (or 9remote.cc) on your phone
4. Scan the QR → connected instantly

Keys are never stored on our servers after the session ends.

Remote Desktop requires two system permissions on macOS:

1. Screen Recording — System Settings → Privacy & Security → Screen Recording → enable Terminal (or 9Remote Desktop app)
2. Accessibility — System Settings → Privacy & Security → Accessibility → enable Terminal (or 9Remote Desktop app)

Then enable in 9Remote:

TUI menu → Remote Desktop → Toggle ON

Performance:

• Adaptive framerate: 60ms active / 400ms idle
• Tile-based diff rendering (only changed regions sent)
• WebRTC DataChannel for minimal latency

Expose your local dev servers (e.g. localhost:3000, localhost:5173) to your phone automatically.

9Remote auto-detects running ports and proxies them:
  http://localhost:3000  →  https://<tunnel>/proxy/3000/
  http://localhost:5173  →  https://<tunnel>/proxy/5173/

Perfect for:

• Testing responsive design on real devices
• Sharing WIP builds with clients
• Mobile debugging without USB cable

❓ Frequently Asked Questions

Yes. 9Remote uses a Pair Device approval system — every new device must be explicitly approved by you before it can access the host. Plus:

• No open ports on your machine (Cloudflare tunnel, outbound-only)
• Keys are never stored on our servers after the session ends
• No terminal output, files, or screen data is collected
• One-time QR keys expire in 30 minutes
• Pending/rejected devices can be managed anytime from the TUI menu