Stop, uninstall or fix a server terminal
Stop or remove a server
- Pause access: on the server, run ~/.local/bin/honkip and choose SSH terminal — open in your browser → Stop terminal access. Choose Start terminal access to turn it back on.
- Uninstall from the server: in the same menu, choose Remove browser terminal and confirm. It stops the agent, cancels its access on HonkIP and removes its key and files. Your other SSH keys and files stay. If it could not reach HonkIP, it says so; then disconnect the server on honkip.com.
- Disconnect on honkip.com: on Server terminals, press Disconnect server. Its open terminals close. This works even after your add-on ends. Then press Delete terminal to remove the old entry and its old sharing links. Deleting the entry does not uninstall the app from the server. To connect it again, on the server choose Remove browser terminal, then Set up browser terminal on this server. Remove will say online revocation could not be confirmed; after a disconnect that is expected.
Used the terminal-only setup? It has no ~/.local/bin/honkip menu. To check it, run (cd "$HOME/.local/share/honkip-terminal" && .venv/bin/python -B -m connect_service.terminal_install status) on the server. Put stop, start or uninstall in place of status to stop, start or remove it. start also offers to keep access running after sign-out and restart.
If something goes wrong
- Offline — terminal access is not connected: on the server, run ~/.local/bin/honkip, choose SSH terminal — open in your browser → Start terminal access, then press Refresh status.
- That setup code is invalid or has expired. Check that you typed the code the server shows. Each code works once, for 10 minutes. If setup on the server says the code expired, run setup again for a new code.
- Check your current account password. Use your HonkIP password, not your Linux password.
- The two-factor code is invalid or already used. Each code works once. Wait for the next code in your app.
- An active browser-terminal add-on on Pro is required. Your Pro plan or add-on is not active. Your servers show as offline until it is active again. You can still disconnect them: on Server terminals, open Review servers already linked to your account, enter your HonkIP password and press Unlock terminal access. If you use an authenticator, that section is not shown: enter its code under Enter your authenticator code to unlock terminal access and press Unlock terminal access. Then press Disconnect server.
- Close an existing terminal before opening another. Your account's terminal limit is reached. Press Disconnect in another terminal, or stop a sharing link.
- The monthly Connect data allowance has been reached. Terminals and Connect share one monthly allowance.
- Disconnect an unused server before adding another. You already have 20 connected servers.
- An installation or unfinished setup already exists. Use status or uninstall first. Choose Check terminal status, then Remove browser terminal if needed, and set up again.
Prefer your own SSH app? On the server, run ~/.local/bin/honkip and choose Other connections — SSH apps, Remote Desktop, games → Share a service — SSH / SFTP, Remote Desktop, TCP / UDP. Game servers and other TCP/UDP services with Connect explains Private and Open. Still stuck? Send a signed-in support request.
More: Server terminals: open your Linux server from the browser
Still stuck? Sign in and send a support request.