Native Installation

No Docker required. Access host binaries like claude, git, gh, etc.

Prerequisites

Linux
macOS

sudo apt install ttyd tmux
# Or: sudo snap install ttyd

  brew install ttyd tmux go

Installation

Install dependencies (see above)
Run deploy command
Terminal window
```
./scripts/termote.sh install native
```
Access at http://localhost:7680

When to Use

Need access to host binaries (claude, git, gh, etc.)
No Docker/Podman available
Full control over services

Service Management

# Check processes
ps aux | grep ttyd
ps aux | grep tmux-api

# Restart
./scripts/termote.sh install native

Troubleshooting

Quick Diagnostics

./scripts/termote.sh health   # Health check
ss -tlnp | grep -E "7680|7681"  # Check ports

Check Processes

ps aux | grep ttyd         # Check if ttyd is running
ps aux | grep tmux-api     # Check if tmux-api is running
lsof -i :7680              # Verify main port
lsof -i :7681              # Verify ttyd port

Debug with Logs

Native mode discards logs by default. To see logs:

# Stop services
./scripts/termote.sh uninstall native

# Start ttyd with logs (terminal 1)
ttyd -W -i lo -p 7681 tmux new-session -A -s main

# Start tmux-api with logs (terminal 2)
cd tmux-api
TERMOTE_PORT=7680 TERMOTE_BIND=127.0.0.1 \
TERMOTE_PWA_DIR=../pwa/dist ./tmux-api-native

Common Issues

Issue	Solution
Port in use	`lsof -i :7680` then kill process
ttyd missing	`brew install ttyd` (macOS) or `apt install ttyd`
Binary missing	`cd tmux-api && go build -o tmux-api-native .`
PWA not built	`cd pwa && pnpm build`

tmux Session

tmux list-sessions         # List sessions
tmux attach -t main        # Attach to session
tmux kill-session -t main  # Reset session

API Test

curl http://localhost:7680/api/tmux/health
curl http://localhost:7680/api/tmux/sessions

Updating

Via One-liner

Re-run the installer - it compares versions and prompts before updating:

curl -fsSL https://raw.githubusercontent.com/lamngockhuong/termote/main/scripts/get.sh | bash

Options:

--yes - Auto-update without prompt
--download-only - Download only, no install

Manual Update

./scripts/termote.sh uninstall native
git pull origin main
./scripts/termote.sh install native

Uninstall

./scripts/termote.sh uninstall native