title
Deploy with Source Codes

The Dashboard contains both manager-api and web, but web is optional.

The manager-api and web will be included in this build guide product.

Prerequisites

Before using source codes to build, make sure that the following dependencies are installed in your environment.

Golang 1.13+: 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

Clone the project

$ git clone -b v2.4 https://github.com/apache/apisix-dashboard.git

$ cd apisix-dashboard
$ make build

When the build is complete, the results are stored in the root output directory.

Note: make build will build manger-api and 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.

Check and modify the configuration information in output/conf/conf.yaml according to your deployment environment.
Launch the Dashboard

$ cd ./output

$ ./manager-api

# or running in background
$ nohup ./manager-api &

Without changing the configuration, visit http://127.0.0.1:9000 to use the dashboard with GUI, where the default username and password are admin.
Stop the Dashboard

manager-api provides a sub command stop to quit the program gracefully, just run:

$ ./manager-api stop

the output directory mention above is the default working directory.

You can move the entire directory to any path you want, and use the -p to specify it as the working directory.

For example, you can move it to /usr/local/apisix-dashboard/

$ mv ./output/manager-api /usr/local/bin/

$ mv ./output/ /usr/local/apisix-dashboard/

$ manager-api -p /usr/local/apisix-dashboard/