opened image

    Docker has become one of the most popular tools for developers and system administrators due to its ability to isolate applications in containers. In this article, we will discuss how to install and configure X-UI in Docker on an Ubuntu server.

    Step 1: Installing Docker and Docker Compose

    Before we begin working with X-UI, we need to install Docker and Docker Compose. Follow the instructions below:


    Installing the necessary dependencies:

    apt-get install ca-certificates curl gnupg
    install -m 0755 -d /etc/apt/keyrings


    Adding the Docker repository:


    curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    chmod a+r /etc/apt/keyrings/docker.gpg
    echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null


    Updating the repositories and installing Docker:

    ​​​​​​​apt-get update 
    apt-get install docker-ce docker-ce-cli docker-buildx-plugin docker-compose-plugin
    systemctl enable docker


    Installing Docker Compose:

    curl -SL -o /usr/local/bin/docker-compose
    ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
    chmod +x /usr/local/bin/docker-compose


    Step 2: Installing and Configuring X-UI

    Now that we have Docker installed, we can proceed to installing X-UI.

    Creating the file docker-compose.yaml:

    vim docker-compose.yaml


    Adding the following configuration code to the file:


    version: "3.9"
        image: alireza7/x-ui
        container_name: x-ui
          - $PWD/db/:/etc/x-ui/
          - $PWD/cert/:/root/cert/
          XRAY_VMESS_AEAD_FORCED: "false"
        tty: true
        network_mode: host
        restart: unless-stopped


    Launching the X-UI container:

    docker-compose up -d


    After executing these commands, X-UI will be installed and running on your server. Note that due to the network_mode: host parameter, the container will use the host's network stack directly, making its configuration easier but removing the possibility of port forwarding.



    Docker provides a convenient and flexible way to manage applications on a server. X-UI, installed in Docker, offers ease of deployment and management, providing a reliable and stable solution for your infrastructure. Follow this guide, and you will be able to quickly and easily start working with X-UI on your Ubuntu server.