Installation guide

Requirements

Ports

Ports 80, 443 and the panel port must be free before installing. Databases and Redis stay bound to localhost.

Install

Connect to your server over SSH and run:

The installer:

1. checks the OS, architecture, memory, disk, hostname and required ports;
2. installs system packages (Nginx, PostgreSQL, Certbot, UFW, fail2ban, Node.js LTS and optionally MariaDB, mail and DNS);
3. downloads the latest release for your architecture and verifies its SHA-256 checksum and ed25519 signature;
4. creates service accounts, directories, secrets and the panel database;
5. configures Nginx, the firewall and hardened systemd services;
6. creates the first Super Admin and prints a one-time password.

Installer options

Pass options after bash -s --, for example:

curl -fsSL https://ptpanel.in/install.sh | sudo bash -s -- --admin-email you@example.com --hostname panel.example.com

After installing

1. Open the panel URL printed at the end (https://your-hostname:7800) and sign in with the one-time password. You will be asked to choose a new password.
2. The panel starts with a temporary self-signed certificate — your browser warns once. Point a domain at the server and attach it in Settings to get a trusted certificate.
3. Back up /etc/ptpanel/master.key offline. It decrypts stored secrets such as deploy keys and DNS tokens.
4. Restrict the panel port to your IP addresses under Security → Firewall if you can.
5. Add your first website, then connect a Git repository to deploy.

Upgrade & rollback

sudo ptpanel upgrade            # latest release on your channel
sudo ptpanel upgrade 1.2.0      # a specific version
sudo ptpanel rollback           # switch back to the previous release

Upgrades download and verify the new release, switch to it atomically and run a health check. If the health check fails, the previous release is restored automatically. Database migrations are forward-only — take a backup before major upgrades.

The panel can also check for updates itself; see Download for release notes.

Uninstall

sudo ptpanel uninstall          # removes the panel; keeps hosted sites, data and config
sudo ptpanel uninstall --purge  # ALSO deletes hosted sites, backups and panel data

A normal uninstall keeps websites running under Nginx and leaves /srv/ptpanel and /etc/ptpanel in place. --purge asks you to type a confirmation phrase before deleting anything.

CLI reference

Commands that change the system must be run with sudo.

Verifying releases

Each release archive on the download page has two companions: .sha256 (checksum) and .sig (base64 ed25519 signature). The installer verifies both automatically. To check an archive by hand:

V=1.0.0; A=amd64; F=ptpanel-$V-linux-$A.tar.gz
curl -fsSLO https://ptpanel.in/releases/$V/$F
curl -fsSLO https://ptpanel.in/releases/$V/$F.sha256
curl -fsSLO https://ptpanel.in/releases/$V/$F.sig
sha256sum -c $F.sha256
base64 -d $F.sig > $F.sig.bin
openssl pkeyutl -verify -pubin -inkey release-public.pem -rawin -in $F -sigfile $F.sig.bin

The public key is embedded in the installer script (RELEASE_PUBKEY).

Machine-readable release information is available at /api/releases/latest?channel=stable and /api/releases.

Files & services

Troubleshooting

• “port 80 is already in use” — another web server (often Apache) is running. Remove it or install on a fresh server.
• Panel not reachable — run sudo ptpanel status, then sudo ptpanel logs api. Check that the panel port is open in your cloud provider’s firewall too.
• Signature verification failed — do not bypass it. Re-download the installer from this site and try again; if it persists, tell us via the security contact.
• Lost admin password — create a new Super Admin with sudo ptpanel create-admin you@example.com.

Still stuck? Ask in the community forum.