---
title: "Deploy the Apisix gateway + graphical management in five minutes with Docker compose"
url: https://www.geekcorelab.cn/en-US/post/docker-compose-five-minute-deployment-of-apisix
updated: 2026-11-08T08:09:02.607569Z
author: "hhjmk"
summary: "文章详细介绍了使用Docker Compose部署APISIX网关系统的完整流程。首先安装必要工具并克隆官方仓库，然后配置dashboard和docker-compose.yml文件，启动包含apisix、etcd、dashboard、prometheus和grafana的服务集群。最后通过web界面访问系统，配置Grafana监控，并启用Prometheus插件解决监控数据传输问题，完成整个网关环境的搭建与监控配置。"
---

# Deploy the Apisix gateway + graphical management in five minutes with Docker compose

First, let's confirm that Git and Vim are already installed on the server, since we'll need them later

Since we are using Ubuntu, the commands are

```
apt-get update
apt-get install git vim -y
```

After the execution is complete, clone the official repository

```
git clone https://github.com/apache/apisix-docker.git
cd apisix-docker/example
```

Next, there is one more thing we need to do: copy the dashboard configuration file over. The official setup places it in the all-in-one directory; we will put it in the same directory as the docker-compose file, which makes it easier to mount into the container.

```
cp ../all-in-one/apisix-dashboard ./
```

Modify the docker-compose.yml file. If you don't want to modify it, you can just delete it and create a new one, then fill in the content below.

```
version: "3"

services:
  apisix:
    image: apache/apisix:${APISIX_IMAGE_TAG:-3.9.0-debian}
    # 如果不手动指定版本，则默认使用官方的3.9.0（官方的示例中写的，但是最新版已经到3.10.0了
    restart: always
    volumes:
      - ./apisix_conf/config.yaml:/usr/local/apisix/conf/config.yaml:ro
    depends_on:
      - etcd
    ports:
      - "9180:9180/tcp"
      - "9080:9080/tcp"
      - "9091:9091/tcp"
      - "9443:9443/tcp"
      - "9092:9092/tcp"
    networks:
      apisix:

  etcd:
    image: bitnami/etcd:3.5.11
    restart: always
    volumes:
      - etcd_data:/bitnami/etcd
    environment:
      ETCD_ENABLE_V2: "true"
      ALLOW_NONE_AUTHENTICATION: "yes"
      ETCD_ADVERTISE_CLIENT_URLS: "http://etcd:2379"
      ETCD_LISTEN_CLIENT_URLS: "http://0.0.0.0:2379"
    ports:
      - "2379:2379/tcp"
    networks:
      apisix:
  dashboard:
    image: "apache/apisix-dashboard:3.0.0-centos"
    restart: always
    depends_on:
      - etcd
    volumes:
      - ./apisix-dashboard/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml:ro
    ports:
      - "9000:9000/tcp"
    networks:
      - apisix
  # 官方版本这里有两个nginx的容器，为了是测试用的，但我们不需要它，所以这里直接删掉了
  prometheus:
    image: prom/prometheus:v2.25.0
    restart: always
    volumes:
      - ./prometheus_conf/prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
    networks:
      apisix:
  grafana:
    image: grafana/grafana:7.3.7
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - "./grafana_conf/provisioning:/etc/grafana/provisioning"
      - "./grafana_conf/dashboards:/var/lib/grafana/dashboards"
      - "./grafana_conf/config/grafana.ini:/etc/grafana/grafana.ini"
    networks:
      apisix:
networks:
  apisix:
    driver: bridge

volumes:
  etcd_data:
    driver: local
```

After that, we can run the command to deploy Apisix

```
docker compose up -d
```

![](/uploads/import-placeholder/235)
The directory structure after deployment looks like this

Next, we can check the default username and password, and visit the web page to log in and manage it. Access your server IP plus the port; the port is 9000. However, since port 9000 on my machine was already taken, I changed it to 29000. So with my server IP, the access address is as follows:

http://100.101.110.53:29000/

```
cat ./apisix-dashboard/conf.yaml
```

![](/uploads/import-placeholder/192)
After logging in, you will be redirected to the dashboard page. If it prompts that Grafana is not configured, you can configure it here:

The address to enter is also your server IP plus port, but here you need to include http://. The default port of Grafana is 3000.

![](/uploads/import-placeholder/125)
We can also view the monitoring information by opening this address directly

![](/uploads/import-placeholder/102)

![](/uploads/import-placeholder/255)
But by default all of these have no data; only Nginx has monitoring data, and Apisix's monitoring data is not being passed over. So how do we solve this problem? Let's go back to the Apisix web management page and add a plugin by following the steps below.

![](/uploads/import-placeholder/241)
Scroll down, find the Prometheus monitoring plugin, and just enable it.

![](/uploads/import-placeholder/386)
After enabling it, just submit.

![](/uploads/import-placeholder/10)
