Container Installation

Single container with tmux-api (PWA + proxy) + ttyd + tmux.

Quick Start

Run deploy command
Terminal window
```
./scripts/termote.sh install container
```
Access at http://localhost:7680

(Optional) Expose to LAN

./scripts/termote.sh install container --lan

Docker Run

# Basic (auto-generates credentials, check logs: docker logs termote)
docker run -d --name termote -p 7680:7680 ghcr.io/lamngockhuong/termote:latest

# With custom credentials
docker run -d --name termote -p 7680:7680 \
  -e TERMOTE_USER=admin -e TERMOTE_PASS=secret \
  ghcr.io/lamngockhuong/termote:latest

# Without auth (local dev only)
docker run -d --name termote -p 7680:7680 \
  -e NO_AUTH=true \
  ghcr.io/lamngockhuong/termote:latest

# With persistence
docker run -d --name termote -p 7680:7680 \
  -v termote-data:/home/termote \
  ghcr.io/lamngockhuong/termote:latest

Options

Flag	Description
`--lan`	Expose to LAN (default: localhost)
`--no-auth`	Disable basic auth
`--port <port>`	Custom port (default: 7680)

Troubleshooting

Quick Diagnostics

./scripts/termote.sh health   # Health check
docker ps -a | grep termote   # Check container status

View Logs

docker logs termote           # View logs
docker logs -f termote        # Follow logs (live)

# Or with podman:
podman logs termote

Container won’t start

# Check startup errors
docker logs termote

# Port already in use?
lsof -i :7680

# Use different port
./scripts/termote.sh install container --port 7690

Debug inside container

docker exec -it termote /bin/sh
# Inside container:
ps aux                        # Check processes
curl localhost:7681           # Test ttyd
curl localhost:7680/api/tmux/health

Common Issues

Issue	Solution
Port in use	`lsof -i :7680` then kill or use `--port`
Container crash	`docker logs termote` to see error
Auth not working	Restart container, check logs for password
WebSocket error	Check ttyd running inside container

Restart / Reset

docker restart termote

# Full reset
./scripts/termote.sh uninstall container
./scripts/termote.sh install container

API Test

curl http://localhost:7680/api/tmux/health
curl -u admin:password 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 -s -- --container

Options:

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

Manual Update

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

Uninstall

./scripts/termote.sh uninstall container