Skip to content
HipnoTypePanel

Operations

Troubleshooting

Doctor output, locked out, tunnel offline, blank page — real fixes for real situations.

Updated Edit this page on GitHub

First: run the doctor

hypno doctor --json   # machine-readable, with fix suggestions

Common situations

I am locked out of the panel

  • SSH in and run hypno reset password --random (prints a one-time password) or hypno reset emailpass.
  • Lost 2FA? hypno 2fa disable (typed email confirmation, audit-logged).
  • URL compromised or forgotten? hypno rotate issues a fresh one (requires CLI auth on the box).

The panel URL returns 503 'tunnel offline'

  • Your VPS is down or the panel service stopped — check systemctl status hipnod and hypno tunnel status.
  • hypno tunnel restart re-establishes the outbound tunnel.
  • The relay being briefly unavailable also shows as offline — it recovers automatically (the tunnel client reconnects with backoff).

The panel page loads but is blank

  • Check hypno logs -n 100 for server-side errors.
  • A browser hard-refresh (Ctrl/Cmd+Shift+R) clears stale chunks after an update.
  • Check the browser console for blocked requests and report the exact messages if they persist.

Docker apps fail to deploy

  • hypno status shows the honest Docker backend state — install Docker from the Apps screen if it is missing.
  • On LXC containers, Docker needs security.nesting=true on the host (see Requirements).