9remote-beta

9Remote — Terminal in Your Pocket

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

🚀 Quick Start • 💡 Features • 🌐 Website • 📖 Docs

🤔 Why 9Remote?

Remote access today is painful:

• ❌ SSH — firewall rules, port forwarding, SSH keys
• ❌ VPN — overkill just to check a terminal
• ❌ ngrok / tunnels — expire, lose connection
• ❌ TeamViewer — slow, desktop-only, paid
• ❌ Termius — SSH-only, no desktop, no browser

9Remote solves all of it:

• ✅ One command — install, scan QR, done in 30 seconds
• ✅ Auto tunnel — Cloudflare tunnel, no port forwarding
• ✅ All-in-one — terminal + desktop + file explorer + editor
• ✅ Works on phone — full workspace from browser, <50ms latency
• ✅ Persistent — PTY sessions survive restarts
• ✅ Pair Device — only approved devices connect, zero signup

⚡ Quick Start

npm install -g 9remote
9remote

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

Works on macOS, Linux, Windows. Requires Node.js 20+.

CLI Commands

✨ Features

🎯 Use Cases

Code from bed — 11 PM, bug in prod, laptop in another room? Open the app on your phone, scan QR, fix, push, sleep.

Fix bugs at a cafe — Production down, only phone + café Wi-Fi? Connect to your home Mac, tail logs, edit config, deploy.

Deploy on vacation — Client needs a hotfix, you're on the beach? Phone → 9remote → git pull → deploy → back to the beach.

On-call engineer — 3 AM alert, don't want to boot laptop? Push notification → terminal + remote desktop from bed.

📖 Setup

http://localhost:3000  →  https://<tunnel>/proxy/3000/
http://localhost:5173  →  https://<tunnel>/proxy/5173/

❓ FAQ

🐛 Troubleshooting

"Port 2208 already in use"

• Another instance running → pkill -f 9remote and retry
• Or use a different port: PORT=3308 9remote

"Cloudflare tunnel failed to start"

• Check internet connection
• cloudflared auto-installed on first run; otherwise install manually from cloudflared docs

"Screen Recording / Accessibility denied" (macOS)

• Grant permissions in System Settings → Privacy & Security, then restart 9Remote

"QR code expired"

• 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: Settings → Connection → Tunnel only

📧 Links

• Website: 9remote.cc
• Docs: docs.9remote.cc
• GitHub: github.com/decolua/9remote
• Issues: github.com/decolua/9remote/issues
• Community: facebook.com/groups/9teamvn

📄 License

MIT © 9Team