Tailscale Integration

Access your terminal securely from anywhere using Tailscale.

What is Tailscale?

Tailscale creates a secure, private network between your devices. It’s like a VPN, but easier to set up and use.

Why Tailscale?

• No port forwarding — Works through NATs and firewalls
• End-to-end encryption — Traffic is encrypted between devices
• Zero configuration — Just install and connect
• Private by default — Only your devices can access

Setup

1. Install Tailscale

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Windows
# Download from https://tailscale.com/download

2. Connect to Tailscale

tailscale up

3. Enable Tailscale Serve

Visit the link shown when you first run tailscale serve:

tailscale serve --bg http://localhost:7860

4. Start remote-terminal

npm start

Accessing via Tailscale

Your terminal is now available at:

https://your-machine-name.your-tailnet.ts.net/

Commands

Expose a Port

remote-terminal expose 3000

Expose Publicly (Funnel)

remote-terminal expose 3000 --funnel

Warning: Funnel exposes your terminal to the public internet. Use with caution.

Remove All Configurations

remote-terminal unexpose

Check Status

remote-terminal status

Tailscale Serve vs Funnel

Troubleshooting

”Serve is not enabled”

Visit the URL shown to enable Tailscale Serve for your account.

”Not connected”

Run tailscale status to check your connection, then tailscale up if needed.