YakPanel installation Linux

One-command install for YakPanel-server (FastAPI + React): Nginx, Redis, systemd, and a production static build of the UI. Run on a clean server as root (or prefix with sudo).

One-click install

These commands download the installer from your site (path must match how you host the script).

curl

curl -fsSL https://www.yakpanel.com/YakPanel-server/install.sh | bash

wget

wget -qO- https://www.yakpanel.com/YakPanel-server/install.sh | bash

With sudo (non-root shell):

curl -fsSL https://www.yakpanel.com/YakPanel-server/install.sh | sudo bash

Hosting. Replace https://www.yakpanel.com/YakPanel-server/ with your own base URL if the script is mirrored elsewhere. Optional bootstrap: install-curl.sh with YAKPANEL_INSTALLER_BASE — see the repo install-curl.sh header.

After install

Open http://YOUR_SERVER_IP:8888 (default Nginx port; override with PANEL_PORT).
Default login: admin / admin — change the password immediately.
Default install path on disk: /www/server/YakPanel-server.
Systemd unit: YakPanel-server.service (backend on 127.0.0.1:8889 by default).

Supported systems

Installer uses apt on Debian/Ubuntu (Nginx sites-available layout) and dnf/yum on common RHEL-family distros.

Environment	Notes
`Ubuntu 22.04+` / `Debian`	Documented in project README; use a clean OS image when possible.
`Rocky / Alma / EL`	`firewalld` port opened for `PANEL_PORT` when active.
Python	Backend expects Python 3.11+; Ubuntu 24.04 is a simple target for stock `python3`.

Optional environment variables

Preserve variables through sudo: sudo -E bash install.sh or sudo -E env VAR=value bash install.sh.

Variable	Purpose
`REPO_URL`	Git URL to clone (default in script).
`YAKPANEL_BRANCH` / `GIT_REF`	Shallow clone branch or tag.
`INSTALL_PATH`	Install directory (default `/www/server/YakPanel-server`).
`PANEL_PORT` / `BACKEND_PORT`	Nginx public port / Uvicorn localhost port.
`YAKPANEL_SOURCE_DIR`	Skip git: directory that already contains `backend/` and `frontend/`.

From a cloned repository

cd YakPanel-master/YakPanel-server
sudo bash install.sh

Or delegate from scripts/install.sh (sets YAKPANEL_SOURCE_DIR automatically).

Docker (evaluation)

For containers, use Docker Compose in the repo (ports differ from native Nginx install):

cd YakPanel-master/YakPanel-server
docker compose up -d