How to install in Docker
Docker is the easiest way to get started with self-hosted Sparrow. This guide assumes you are running the command from the machine you intend to host from.
Before you begin
You need the following installed in your system: Git, Docker and Docker Compose.
Installation
-
Clone the Sparrow App repository:
git clone https://github.com/sparrowapp-dev/sparrow-app
cd sparrow-app -
Configure
.env.docker-setup
You can move ahead with the default values or customize the environment variables in
.env.docker-setup
according to the Environment Variable Guide. -
Once the env file is setup, start all the services using Docker Compose by running the following command:
yarn docker:up
Upon successful execution of the above command, the following services will be started inside different docker containers:
- Sparrow Web Server
- Sparrow API Server
- Sparrow Auth Server
- Sparrow Proxy Server
- MongoDB
- Kafka
-
Access the Sparrow App via the web browser at http://localhost:1422.
Stopping the Services
In order to stop all the services, run the below command:
yarn docker:down