> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# aaPanel Deployment

Deploy LangBot with one click using [aaPanel](https://www.bt.cn/new/download.html?r=dk_LangBot).

<Warning>
  If you already have aaPanel installed, please update to version **9.2.0** or higher
</Warning>

## Installing aaPanel

> Recommended server systems (from aaPanel): Debian 12, Ubuntu 22, etc.
>
> This document assumes you have a server with a public IPv4 address. If you're using a home machine without a public IP, you can access the relevant pages through the internal network mentioned below.

Open [aaPanel](https://www.bt.cn/new/download.html?r=dk_LangBot), use the Linux panel installation script provided by aaPanel official, and select the corresponding script based on your system.

<img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/langbot/one-click/bt_install_01.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=a5fb690e5ef409ef57d574cb2a5e0a54" alt="Install aaPanel" width="2043" height="872" data-path="images/zh/deploy/langbot/one-click/bt_install_01.png" />

Copy the corresponding script and paste it into your server to execute.

## Installing LangBot

After waiting for a while, aaPanel installation will be complete.

You'll see a message similar to this, copy the external panel address and open it in your browser.

<img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/langbot/one-click/bt_install_02.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=3531fa9150a851984900a97fc95560a4" alt="aaPanel Access Address" width="739" height="64" data-path="images/zh/deploy/langbot/one-click/bt_install_02.png" />

When you first open it, you should see a popup for `Recommended Installation Suite`. You can skip this by closing it.

Then click on `docker` in the sidebar. If it's your first time, you'll be prompted to install Docker and Docker Compose services. Click "Install Now" if prompted, or ignore if already installed.

Then go to `Docker -> App Store`, search for `LangBot` (note the case sensitivity), click `Install`, and use the default configuration.

After a short wait, you'll see a container named `langbot_XXXX` showing as `Running`.

<img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/langbot/one-click/bt_langbot_01.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=2cbf7fd2f0684f2b778d7b62599716ed" alt="Create LangBot Container" width="1132" height="240" data-path="images/zh/deploy/langbot/one-click/bt_langbot_01.png" />

Click the red circle in the image above to view the running logs.

<img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/langbot/one-click/bt_langbot_02.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=a8bedf29e0ac22c82ecbae5d8c1a2142" alt="View LangBot Container Logs" width="1230" height="905" data-path="images/zh/deploy/langbot/one-click/bt_langbot_02.png" />

You can see the external and internal access paths for the WebUI configuration page (visual configuration page). Copy the public address, for example `http://xxx.xxx.xxx.xxx:5300` (where xxx.xxx.xxx.xxx is your aaPanel IP, and 5300 is the port number, which may vary as shown in the image).

After opening it, enter your admin email and password, then click initialize.

You can then proceed with configuration in the visual interface.

If you prefer to directly modify JSON configuration files, you can look at the local mapping directory shown in the image above. Go to the installation directory, where the `data` folder is used to store configuration files, and the `plugins` folder is used for plugin-related files.

Next, please continue reading the [Deploy Message Platform](/en/deploy/platforms/readme) page.
