Install ZenTerm Gateway on your server, run the setup command, and scan the QR code with the ZenTerm app. See the Quick Start guide for details.
The app can't connect to my server.
Make sure tmux is installed, the AUTH_TOKEN matches, and your device can reach the server (check firewall rules and VPN connectivity). The server's default port is 18765.
Can I use ZenTerm over the internet?
Yes. Use a VPN like Tailscale or WireGuard for secure remote access. ZenTerm works over any network that can reach your server.
Is my data sent to any third party?
No. ZenTerm communicates only with your own server. There is no analytics, tracking, or cloud service involved. See our Privacy Policy.
Which servers are supported?
Any Linux or macOS machine with Node.js 20+ and tmux. Common setups include Mac mini, Raspberry Pi, Ubuntu/Debian servers, and VPS instances.
Troubleshooting
Verify tmux is installed: tmux -V
Check the gateway is running: curl http://your-server:18765/health
Confirm the AUTH_TOKEN in ~/.config/zenterm/.env matches the token in the app
For LAN connections, ensure both devices are on the same network
For VPN connections, verify the VPN tunnel is active and the server is reachable