Quick Start / Documents / Videos
What is sparrow and why should we use sparrow?
A Docker tool for one-click startup of multiple services.
Add a new service, please click here.
Here is a quick usage example. You can check Usage Document for detailed tutorials.
demo.mp4
You can use the following commands to install.
# get project
git clone https://github.com/WGrape/sparrow.git
cd sparrow
# install
bash _install.shAfter successful installation, a .env file will be automatically generated in the project's root directory, it's the config entry for Sparrow, you can modify service versions, container namespace, and more. Refer to the .env.template file.
1、If you encounter some syntax errors while using the
./sparrow xxxcommand, please try to run with bashbash ./sparrow xxxcommand.2、When install, you will be prompted to enter
DOCKERHUB_REPO, which is used to configure the remote repository for your Sparrow images. It's default value is docker.io/lvsid, if you need to modify it later, you can directly edit the.envfile.3、If you need help, check the Q&A Document for more help.
Use the following command to start all services in the entire environment. Of course, this all services can be defined and is controlled by the ENABLE_SERVICE_LIST array variable configured in the /.env file in the root directory.
./sparrow startIf you only need to start a specific service, you can use the following command. The service passed in is the name of a service in the services list in the docker-compose.yml configuration file, such as phpfpm/nginx/mysql/redis, etc.
./sparrow startone {service_name}Stop all services in the entire environment
./sparrow stopThe same, if you only need to stop a specific service, you can use the following command.
./sparrow stopone {service_name}Restart all services in the entire environment
./sparrow restartWhen a service needs to be updated, such as when its image content needs to be modified, the service (image) needs to be updated after making the modifications. After modifying it manually, use the following command to update it.
./sparrow updateone {service_name}- 1.Project Background :English / 中文
- 2.Usage Document :English / 中文
- 3.Development Document :English / 中文
- 4.How to contribute :English / 中文
- 5.Q&A Document :English / 中文
During the use of the project, if you have any questions or suggestions, please submit issues or pull requests any time. About Contribution,please check How to Contribute document.
