FAQ

Is 3x-ui free and open source?

Yes. 3x-ui is open source under the GPL-3.0 license. The source is on GitHub.

What systems does it run on?

Most major Linux distributions (Ubuntu, Debian, CentOS/RHEL and derivatives, Fedora, Arch, Alpine, and more) across amd64, arm64, and other architectures. It also runs as a Docker container. See Installation.

SQLite or PostgreSQL?

SQLite is the default and is fine for most deployments. PostgreSQL is available for larger setups via XUI_DB_TYPE=postgres and XUI_DB_DSN — see the environment variables.

Which client apps work with it?

Any Xray-compatible client — for example v2rayNG, Hiddify, and Clash/Mihomo. Import a client's share link or QR code, or use a subscription.

How is 3x-ui different from x-ui?

3x-ui is an enhanced fork of the original X-UI project. It adds broader protocol support, improved stability, per-client traffic accounting, multi-node management, a 13-language UI, and many quality-of-life features.

How do I update?

Re-run the install script (it updates in place), or pull the new Docker image. See Installation and the releases page.

Where can I get help?

Join the official Telegram channel @XrayUI for announcements and community support, or open an issue on GitHub. For common problems, start with Troubleshooting.