Installing Apache APISIX Dashboard on Linux is easy. Now, we provide Docker image and RPM installation package.
We recommend using Docker to run Dashboard:
docker pull apache/apisix-dashboarddocker run -d --name dashboard \ -p 9000:9000 \ -v <CONFIG_FILE>:/usr/local/apisix-dashboard/conf/conf.yaml \ apache/apisix-dashboard
<CONFIG_FILE> to your configure file path.
NOTE: Only CentOS 7 is supported currently, for more information, please refer to here.
# 1. install RPM packagesudo yum install -y https://github.com/apache/apisix-dashboard/releases/download/v2.11.0/apisix-dashboard-2.11.0-0.el7.x86_64.rpm
# run dashboard in the shellsudo manager-api -p /usr/local/apisix/dashboard/ # or run dashboard as a servicesystemctl start apisix-dashboard
Without changing the configuration, visit
http://127.0.0.1:9000 to use the dashboard with GUI, where the default username and password are
The Dashboard project contains both
web is optional.
web will be included in this build guide product.
Before using source codes to build, make sure that the following dependencies are installed in your environment.
- Golang 1.13+
Tip: For users in mainland China, you can use the following command to speed up the module downloads.
$ go env -w GOPROXY=https://goproxy.cn,direct
git clone -b release/2.10.1 https://github.com/apache/apisix-dashboard.git && cd apisix-dashboard
cd apisix-dashboardmake build
When the build is complete, the results are stored in the root
make build will build
web, use the
make help command to see more commands.
- After the build is complete and before you start, make sure the following dependencies are installed and running in your environment.
- etcd 3.4.0+
Check and modify the configuration information in
output/conf/conf.yamlaccording to your deployment environment.
Launch the Dashboard
cd ./output ./manager-api
- Without changing the configuration, visit
http://127.0.0.1:9000to use the dashboard with GUI, where the default username and password are
You will need to handle your own service management when deploying using the source code compilation method. We provide a service file template for operating systems that use the Systemd service manager.
mkdir -p /usr/local/apisix-dashboardcp -rf ./output/* /usr/local/apisix-dashboard
- Create service unit
Copy the following or use this file directly, you need to copy it to the
/usr/lib/systemd/system directory and execute the
systemctl daemon-reload command.
# copy service unitcp ./api/service/apisix-dashboard.service /usr/lib/systemd/system/apisix-dashboard.servicesystemctl daemon-reload # or: If you need to modify the service unit, you can use the following commandecho "[Unit]Description=apisix-dashboardConflicts=apisix-dashboard.serviceAfter=network-online.target [Service]WorkingDirectory=/usr/local/apisix-dashboardExecStart=/usr/local/apisix-dashboard/manager-api -c /usr/local/apisix-dashboard/conf/conf.yaml" > /usr/lib/systemd/system/apisix-dashboard.service
- Manage service
You can use the following command to manage the service.
# start apisix-dashboardsystemctl start apisix-dashboard # stop apisix-dashboardsystemctl stop apisix-dashboard # check apisix-dashboard statussystemctl status apisix-dashboard