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

npm install -g 9remote
9remote

TUI menu → Remote Desktop → Toggle ON

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

❓ Frequently Asked Questions

🛠️ Tech Stack

• Runtime: Node.js 20+
• Tunnel: Cloudflare Quick Tunnel — zero-config secure tunnel
• Terminal: node-pty — persistent PTY sessions
• Remote Desktop: node-datachannel (WebRTC) + robotjs (input control)
• Real-time: Socket.IO — terminal streaming + WebRTC signaling
• Agent UI: Preact — lightweight embedded dashboard
• Web Client: Next.js 16 + React 19 + Tailwind CSS 4
• Desktop App: Tauri 2 — native shell with auto-updater
• Mobile App: Expo — React Native with WebView shell
• Edge API: Cloudflare Workers — session management + TURN credentials

🐛 Troubleshooting

"Port 2208 already in use"

• Another 9Remote instance is running → pkill -f 9remote then retry
• Or run on a different port: PORT=3308 9remote

"Cloudflare tunnel failed to start"

• Check internet connection
• cloudflared auto-installed on first run — if it fails, install manually: cloudflared docs

"Screen Recording / Accessibility permission denied" (macOS)

• Grant permissions in System Settings → Privacy & Security
• Restart 9Remote after granting

"QR code expired"

• One-time keys expire in 30 minutes → regenerate from TUI menu: Key → Regenerate

"Can't connect from phone"

• Check both devices have internet
• Try forcing tunnel mode (skip LAN): Settings → Connection → Tunnel only

"Remote desktop laggy"

• Reduce resolution in settings
• Switch to terminal-only if desktop not needed
• Use LAN mode if on same Wi-Fi for lowest latency

⭐ Show Your Support

9Remote is in active development and we need your support to reach the open-source milestone!

• ⭐ Star this repo — every star brings us closer to going open-source
• 🐦 Share on Twitter / X — tell other devs about 9Remote
• 💬 Join our Facebook community — facebook.com/groups/9teamvn
• 🐛 Report issues — found a bug? Let us know!
• 💡 Request features — what would make your remote workflow better?

📧 Support & Links

• Website: 9remote.cc
• Documentation: docs.9remote.cc
• NPM Package: npmjs.com/package/9remote
• GitHub: github.com/decolua/9remote
• Issues: github.com/decolua/9remote/issues
• Facebook Community: facebook.com/groups/9teamvn

📄 License

Proprietary — All Rights Reserved.

9Remote is currently in active development and is not open-source yet. The published npm package is free to use, but the source code is not publicly available.

🎯 Open-source milestone: once this repo reaches enough ⭐ support, the full source code will be released under the MIT license.