Guides
Linux Server
Run TurnPanel on a Linux machine as a background service and use it from any browser.
Install
Run the installer on the server as the user TurnPanel should run as, not root. It installs for that user only, starts a background service that survives logout and reboots, and asks for sudo only when system libraries are missing or Ubuntu's sandbox rule needs adding.
curl -fsSL https://turnpanel.com/install.sh | bash- Supports x86-64 and ARM64. Nothing else needs to be installed first beyond curl.
- Re-running the same command updates TurnPanel in place.
Sign in and open it
At the end of the install, the server prints a sign-in link and code. Open the link on any device and approve the server with your TurnPanel account. The server then sets up its public address and prints it. Open that address from any browser signed in to the same account.
- To sign in again later, run `turnpanel login`.
- On your local network you can also use a password: set one with `turnpanel web-password`, then read the pairing emoji with `turnpanel pair`.
Everyday commands
- `turnpanel status` shows the version, web address, account, and public address.
- `turnpanel start`, `stop`, and `restart` control the service.
- `turnpanel logs` follows the service log.
- `turnpanel help` lists every command.
Updates
Install updates from Settings in the browser, or run `turnpanel update`. TurnPanel swaps to the new version and restarts itself. To follow nightly builds, install with `curl -fsSL https://turnpanel.com/install.sh | bash -s -- --channel nightly`.
Troubleshooting
Run `turnpanel doctor`. It checks the display backend, the browser sandbox, whether the agent's browser can draw pages, secret storage, the web server, and free disk space, and says which check failed.
- If the installer warned that the browser sandbox is off, rerun it with sudo available so it can add the sandbox rule.
Uninstall
Run `turnpanel uninstall`. It removes the service and the app, and asks before deleting your TurnPanel data.