Help Center

SSH Client Recommendations

Windows Users

xShell

The industry-standard Windows SSH client. Tabbed multi-session management, key auth, port forwarding, X11 forwarding. Free for home/school use.

Download from official site →

PuTTY

Venerable open-source SSH client. Under 1 MB, no installation required. Ideal for quick sessions or carrying on a USB drive.

Download from official site →

macOS Users

macOS includes a built-in Terminal app — no extra software needed. Open Terminal and run:

Terminal
ssh root@your-server-ip

On first connection you'll be prompted to confirm the host fingerprint. Type yes and press Enter, then enter the root password.

Linux Users

Linux includes the OpenSSH client by default. Simply run ssh root@your-server-ip in your terminal.

How to Install WP Panel

Prerequisites

  • A VPS or dedicated server (minimum 1 CPU core / 1 GB RAM)
  • Operating system: Debian 13 (Trixie)
  • Root user or a user with sudo privileges

Note: Most VPS providers' stock Debian 13 images work with WP Panel out of the box. If you encounter issues during installation or usage, refer to the Clean Debian 13 Reinstall guide.

Step 1: SSH into Your Server

Use an SSH client to connect to your server (see SSH Client Recommendations):

  • Windows: Use xShell or PuTTY
  • macOS: Open Terminal and run ssh root@your-server-ip
  • Linux: Use ssh root@your-server-ip in terminal

Step 2: Run the Install Command

Once connected via SSH, paste the one-liner:

SSH Terminal
apt-get update && apt-get install -y wget ca-certificates && wget -qO- https://raw.githubusercontent.com/naibabiji/wp-panel/main/install.sh | bash

The script automatically: adds Debian repos → installs Nginx / PHP / MariaDB / Redis → downloads WP Panel → configures systemd service → starts the panel.

Step 3: Log Into the Panel

After installation, the terminal prints the panel URL, admin username, and password. Be sure to save these credentials.

If you forget the password, run wp password in SSH to reset it instantly.

Clean Debian 13 Reinstall

When Is a Reinstall Needed?

In most cases, your VPS provider's stock Debian 13 image will run WP Panel without issues. However, if you encounter the following problems, they may be caused by a vendor-modified image, and a clean reinstall is recommended: install script errors, PHP/Nginx service startup failures, panel feature anomalies, or system component version conflicts.

Method 1: bin456789/reinstall Script (Recommended)

Works with most VPS providers worldwide. Automatically detects network and selects the best mirror:

SSH Terminal
curl -O https://raw.githubusercontent.com/bin456789/reinstall/main/reinstall.sh || wget -O ${_##*/} $_

Copy and paste this command into SSH, press Enter. Once it completes, run the following to start Debian 13 installation:

SSH Terminal
bash reinstall.sh 13
  • Follow the prompts to set the username and password for the new system
  • Run reboot to restart the server — it will boot into the reinstall process automatically
  • The reinstall takes about 5-15 minutes; SSH disconnection during this time is normal
  • After the reinstall, SSH port defaults to 22

Method 2: VPS Provider Control Panel

Most VPS providers offer OS reinstall from their control panel. Select Debian 13 (Trixie) latest version, and choose "Minimal install" if available. Note: some providers also use modified Debian templates, so Method 1 is preferred.

Method 3: Official ISO Manual Install

For dedicated servers or VPS that support custom ISOs. Download the Debian 13 netinst image from the Debian website and select minimal system (SSH Server only) during installation.

Migrate from Another Panel

Overview

Migrating requires a clean system. We recommend: install WP Panel on a new server → migrate sites one by one. If you only have one server, back up all data first, then reinstall the OS and install WP Panel.

Preparation

  • Back up website files and databases, then download them locally

Migration Steps

1 Install WP Panel on a new server (or after OS reinstall) using the guide above.
2 Create the corresponding site in WP Panel (same domain name), choose WordPress or PHP type, and check the SSL certificate option.
3 Upload site files via WP Panel File Manager (or upload and extract a backup archive). After completion, click the "Fix Permissions" button, then proceed to the next step.
4 Go to Site Details → Database → Upload Restore, and import your .sql.gz backup.
5 If you had custom Nginx configs, paste them in Site Details → Nginx Custom Config and save.
6 In Site Details → Database, click the "Sync DB Info" and "Change Password" buttons. The panel will auto-update wp-config.php (WordPress sites only; for other sites, update database config manually).

Important Notes

Note: Sites will be temporarily unavailable during migration. We recommend operating during off-peak hours. WP Panel automatically configures WordPress permalink rules — after migration, simply verify that the front-end and admin area function correctly.

Can't find what you need?

Ask on GitHub Issues →