EasyXrayInstallation
Install EasyXray via the official script (stable, pinned, or dev-latest), unattended/cloud-init, or Docker — and choose SQLite or PostgreSQL.
EasyXray runs on a wide range of Linux distributions — Ubuntu, Debian, Armbian,
Fedora, CentOS, RHEL, AlmaLinux, Rocky Linux, Oracle Linux, Amazon Linux,
Virtuozzo, Arch, Manjaro, openSUSE (Tumbleweed/Leap), Alpine — and Windows,
across amd64, 386, arm64, armv7, armv6, armv5, and s390x.
EasyXray is installed fresh. It does not detect or upgrade an existing X-UI / 3x-ui installation — the service name, install paths, environment prefix, and database file all differ. See Migration.
Run the script installer as root (or with sudo). It installs a service,
sets up the easyxray management command, and enables the panel on boot.
The official script is the recommended path. During installation it generates a
random username, password, and access (web base) path, sets up the service,
and installs the easyxray management command.
bash <(curl -Ls https://raw.githubusercontent.com/EasyXrayTeam/EasyXray/main/install.sh)Install a specific version by appending its tag:
bash <(curl -Ls https://raw.githubusercontent.com/EasyXrayTeam/EasyXray/main/install.sh) v1.0.3Install the rolling dev build (the latest per-commit pre-release from main
— not a stable release) by passing dev-latest:
bash <(curl -Ls https://raw.githubusercontent.com/EasyXrayTeam/EasyXray/main/install.sh) dev-latestWhen it finishes, note the printed login details and run easyxray to open the
management menu, then
continue to First login.
Build your install command
Tailor the command to your setup:
Install command builder
Build the exact install command for your setup. It is assembled in your browser.
bash <(curl -Ls https://raw.githubusercontent.com/EasyXrayTeam/EasyXray/main/install.sh)Choose a database
You pick the storage backend at install time:
- SQLite (default) — a single file at
/etc/easyxray/EasyXray.db. Zero setup. - PostgreSQL — for high client counts or multi-node setups. The installer can install it locally or use a DSN you provide.
See Database for details and SQLite→PostgreSQL migration.
Unattended / cloud-init
The installer also runs non-interactively for automation. Set
EASYXRAY_NONINTERACTIVE=1 (or run with no TTY) and it installs end-to-end with zero
prompts, generating random credentials and writing them to
/etc/easyxray/install-result.env:
EASYXRAY_NONINTERACTIVE=1 bash <(curl -Ls https://raw.githubusercontent.com/EasyXrayTeam/EasyXray/main/install.sh)The repo's deploy/
directory has ready-made cloud-init user-data for unattended installs on any
cloud (Hetzner, AWS, DigitalOcean, Vultr, GCP, Azure, Oracle).