How to Download and Install X-UI Unofficial with Docker
How to Download X-UI: A Multi-Protocol and Multi-User Xray Panel with a Web UI
Xray is a powerful network proxy tool that supports multiple protocols such as VMess, VLESS, Trojan, Shadowsocks, Socks, HTTP, etc. It can help you bypass network censorship, access geo-restricted content, and enhance your online privacy and security. However, managing xray servers and users can be challenging, especially if you have multiple servers and protocols to deal with.
download x-ui
That's where x-ui comes in handy. X-ui is a web-based graphical user interface (GUI) for xray that supports multi-protocol and multi-user management. With x-ui, you can easily create, modify, delete, and monitor xray servers and users on your web browser. You can also customize xray configuration templates, apply SSL certificates, enable Telegram bot notifications, and more.
In this article, we will show you how to download and install x-ui on your Linux server, how to apply SSL certificates for secure access, how to use and configure the web UI, and how to migrate from v2-ui if you are using it. By the end of this article, you will be able to manage your xray servers and users with ease using x-ui.
Prerequisites
Before you download and install x-ui, you need to have the following:
How to download x-ui and install it on Linux
Download x-ui for Windows 10 and configure it easily
Download x-ui latest release from GitHub
Download x-ui docker image and run it on your server
Download x-ui English version with Telegram bot support
Download x-ui and migrate from v2-ui with one command
Download x-ui and apply SSL certificate for free
Download x-ui and monitor your system status
Download x-ui and manage multiple users and protocols
Download x-ui and set up traffic limit and expiration date
Download x-ui and customize your xray configuration template
Download x-ui and enable https access to the panel
Download x-ui and use vmess, vless, trojan, shadowsocks, dokodemo-door, socks, http protocols
Download x-ui and get daily traffic notification via Telegram bot
Download x-ui and get panel login reminder via Telegram bot
Download x-ui and get server SSH login reminder via Telegram bot
Download x-ui and get inbounds expiration alert via Telegram bot
Download x-ui and get traffic warning reminder via Telegram bot
Download x-ui and get daily summary at a pre-defined time via Telegram bot
Download x-ui and use fallback and flow settings for trojan protocol
Download x-ui and fix vless link issue
Download x-ui and fix fallback bug
Download x-ui and optimize UI interface
Download x-ui and improve website loading speed
Download x-ui and lower CPU usage for getting system connections
Download x-ui and fix web panel restart function issue
Download x-ui and fix traffic exceed account disable issue
Download x-ui and fix QR code link not containing address issue
Download x-ui and fix listening IP not empty causing xray not to start issue
Download x-ui and fix old iOS system white screen issue
Download x-ui and fix v2ray restart after panel restart issue
Why download x-ui instead of v2-ui for your server
Where to download x-ui source code and how to build it yourself
How to download x-ui updates and upgrade it automatically
How to download x-ui backup file and restore it on another server
How to download x-ui logs file and troubleshoot errors
How to download x-ui user data file and export it to other formats
How to download x-ui inbound data file and import it from other sources
How to download x-ui database file and manage it with SQLite tools
How to download x-ui media file and change the panel logo or favicon
How to download x-ui config file and modify the panel settings manually
How to download x-ui bin file and replace the xray core with a newer version
How to download x-ui service file and register it as a systemd service
How to download x-ui install script file and run it on your server with curl command
How to download x-ui uninstall script file and remove it from your server completely
A server running Linux with root access. You can use any Linux distribution that supports systemd, such as CentOS, Ubuntu, Debian, etc.
A domain name and SSL certificate (optional). If you want to access the web UI over HTTPS, you need to have a domain name that points to your server's IP address and a valid SSL certificate for that domain name. You can use your own domain name and SSL certificate, or you can apply for a free one using the built-in functions of x-ui.
Installation Methods
There are three ways to download and install x-ui on your Linux server: using a single command script, manual installation or upgrade, or using docker. We will explain each method in detail below.
Using a Single Command Script
The easiest way to download and install x-ui is to use the single command script provided by the developer. This script will automatically download the latest version of x-ui from GitHub, extract it to the appropriate directories, set the necessary permissions, create a systemd service file, and start the service. To use this method, simply run the following command as root:
bash < (curl -Ls [16](
The script will prompt you to enter the port number for accessing the web UI. The default port is 54321. You can change it to any port that is not in use by other services on your server. After entering the port number, press Enter to continue.
The script will then download and install x-ui on your server. It may take a few minutes depending on your network speed. When the installation is complete, you will see a message like this:
x-ui Successful installation If it is a new installation, the default web port is: 54321 The default username is: admin The default password is: admin Please make sure that this port is not blocked by firewalls or other software. Otherwise you will not be able to access the panel. x-ui If you want to uninstall x-ui, you can run the following command as root: bash < (curl -Ls [17](
This will stop and remove the x-ui service, delete the x-ui directory and all its files, and restore the original xray configuration file. Manual Installation or Upgrade
If you prefer to download and install x-ui manually, or if you want to upgrade x-ui to the latest version, you can follow these steps: 1. Download the latest release of x-ui from GitHub: [18]( 2. Extract the downloaded file to a directory of your choice, such as /usr/local/x-ui 3. Change the owner and group of the directory and its files to root:root 4. Copy the x-ui.service file to /etc/systemd/system/ 5. Reload the systemd daemon: systemctl daemon-reload 6. Start the x-ui service: systemctl start x-ui 7. Enable the x-ui service to run on boot: systemctl enable x-ui To upgrade x-ui, you can repeat steps 1 to 6, but skip step 5. Using Docker
If you are familiar with docker, you can also use it to download and run x-ui on your server. To use this method, you need to have docker installed and running on your server. You can follow the official documentation to install docker on your Linux distribution: [19]( To download and run x-ui using docker, you can use the following command: docker run -d --name=x-ui --restart=always --network=host -v /etc/localtime:/etc/localtime:ro -v /etc/x-ui:/etc/x-ui vaxilu/x-ui
This will pull the latest image of x-ui from Docker Hub and run it as a container named x-ui. It will also mount the /etc/localtime and /etc/x-ui directories on your host machine to the container, so that you can access and modify the configuration files and logs of x-ui. The --network=host option will allow the container to use the host network, so that you can access the web UI using the host IP address and port. To stop and remove the x-ui container, you can use the following command: docker stop x-ui && docker rm x-ui
To update the x-ui image, you can use the following command: docker pull vaxilu/x-ui
SSL Certificate Application
If you want to access the web UI of x-ui over HTTPS, you need to have a domain name that points to your server's IP address and a valid SSL certificate for that domain name. You can use your own domain name and SSL certificate, or you can apply for a free one using one of the following methods:
Using Cloudflare DNS API
If you are using Cloudflare as your DNS provider, you can use its API to apply for a free SSL certificate from Let's Encrypt. To use this method, you need to have a Cloudflare account and an API token with Zone.Zone and Zone.DNS permissions. You can follow this guide to create an API token: [20](
Once you have your API token, you can run the following command as root:
x-ui ssl --cf-email [your cloudflare email] --cf-key [your cloudflare api token] --domain [your domain name]
This will use acme.sh script to issue a SSL certificate for your domain name using Cloudflare DNS API. The certificate will be saved in /root/.acme.sh/[your domain name]/ directory. The script will also automatically renew the certificate every 60 days.
Using acme.sh Script
If you are not using Cloudflare as your DNS provider, or if you prefer to use another script to apply for a SSL certificate, you can use acme.sh script. This is a shell script that can issue SSL certificates from Let's Encrypt using different DNS providers or webroot methods. You can find more information about acme.sh script here: [21](
To use this method, you need to install acme.sh script on your server first. You can run t