Setup

Install in one command

HipnoType installs on a fresh VPS in about two minutes. It is idempotent — re-running the command upgrades in place without touching your data.

The one-liner

curl -fsSL https://hypnotype.mangocloud.cyou/install.sh | sudo bash

Verify the script first if you prefer: curl -fsSL https://hypnotype.mangocloud.cyou/install.sh -o install.sh && sha256sum -c install.sh.sha256

Before you start

Requirements

VPS	KVM/QEMU VPS (or bare metal) — most providers' standard instances
OS	Ubuntu 22.04 / 24.04 · Debian 12 · AlmaLinux 9 · Rocky 9
Arch	x86_64 or arm64
RAM	1 GB minimum (2 GB+ recommended for Docker app templates)
Disk	10 GB free minimum
Network	Outbound HTTPS (443) — the panel opens no inbound ports
Access	Root (the installer runs with sudo)

Need a VPS first?

Any KVM provider works — DigitalOcean, Hetzner, Vultr, Linode, OVH, Netcup or your own metal. Pick the cheapest 1 GB instance running Ubuntu 24.04 and you are ready. Full environment matrix in Requirements & compatibility.

No magic

What the installer does, step by step

1
Preflight
Root, virtualization type, OS version, architecture, RAM, disk, systemd, cgroups v2, nftables support, conflicting panels (aaPanel, CyberPanel, cPanel…) and outbound reachability are checked — anything missing is reported honestly before anything is touched.
2
Dependencies
curl, git, nftables, fail2ban and Caddy are installed from your distribution's repositories; Docker Engine is installed if you do not skip it (--no-docker).
3
User & directories
A dedicated hipno system user and /opt/hipno, /etc/hipno, /var/lib/hipno, /var/log/hipno and /var/backups/hipno are created with tight permissions.
4
Panel install
The release is downloaded from GitHub Releases, the SHA-256 checksum is verified, and the panel is installed as a hardened systemd service (hipnod).
5
Secrets
A per-install encryption key is generated; an admin email and a one-time temporary password are written to a 0600 env file consumed on first boot.
6
Relay registration
The panel registers itself with the relay over an outbound connection and opens its persistent WebSocket tunnel. Your VPS stays fully firewalled.
7
Health check
hypno doctor runs a real PASS/FAIL sweep and the service state is verified before the summary is printed.
8
Summary
The boxed result prints your panel URL, admin email and the one-time password notice — the password is shown exactly once, then consumed.

Flags for automation: --yes (no prompts), --no-docker, --mode relay|direct, --version <tag>, --uninstall.

Know what to expect

The result you should see

 ┌──────────────────────────────────────────────────────────────────┐
 │  HipnoType Panel installed successfully                          │
 │                                                                  │
 │  Panel URL : https://hypnotype.mangocloud.cyou/server/panel/vDVB3ic7v7uGwnkr73V2FzLuKeKxXc72/
 │  Email     : admin@hypnotype.mangocloud.cyou                     │
 │  Password  : (temporary, shown once — first login forces change) │
 │                                                                  │
 │  Save the URL now — it is the only way in.                       │
 │  Commands  : hypno --help   |   hypno rotate   |   hypno doctor  │
 └──────────────────────────────────────────────────────────────────┘

The 32-character suffix of the URL is the secret. Treat it like a password — and rotate it any time with hypno rotate.

First login

Unlock, harden, explore

1 · Unlock

Open the printed URL. Log in with the admin email and the temporary password from the installer box.

2 · Set your real password

The panel forces a password change on first login (policy-enforced). The temporary password is consumed and gone.

3 · Turn on 2FA

Scan the offered QR code with any authenticator app and store the recovery codes somewhere safe. Done — you are on the dashboard.

Where do I even type this?

Opening a console on common providers

Every provider has a browser console; SSH from your own machine works everywhere too.

DigitalOcean

Control panel → your Droplet → top-right Access → Launch Droplet Console
or SSH from your machine: ssh root@<droplet-ip>

Hetzner

Cloud Console → your Server → </> Console (opens a VNC shell)
or SSH: ssh root@<server-ip> (key or the initial root password from the panel)

Vultr

Products → your instance → View Console (top right)
or SSH: ssh root@<instance-ip>

Linode / Akamai

Cloud Manager → your Linode → Launch LISH Console
or SSH: ssh root@<linode-ip>

AWS Lightsail

Console → your instance → top-right terminal icon (Connect) → browser SSH
or SSH with your key pair: ssh -i <key.pem> ubuntu@<instance-ip> then sudo -i

You are in — now what?

Next steps

Take the 5-minute tour

Dashboard, websites, apps, files, terminal.

Guide

Connect Cloudflare DNS

Scoped token, record import, two-way sync.

Guide

Understand the access URL

Rotation, sessions and the tunnel model.

Guide

Open source, fully

Get the code

Everything is on GitHub — and the install asset is mirrored right here, so the one-liner works even before you publish a release.

Panel source (installer asset)

The exact archive install.sh builds from — served from this domain at /downloads/panel-source.tar.gz and verified against its checksum.

The full repository

Panel, relay, terminal service, installer, docs and the website source live in one repo: Arsh0712/HypnoPanel. Releases carry the same checksummed archives.

This website (Vercel)

The site you are reading is the website/ folder of the repo — a standalone Next.js app. Import it in Vercel with the deploy guide.