Installing Zango with Docker
Pre-requisites
To begin using Zango through Docker installation, ensure that Docker and Docker Compose are installed on your machine. If not, follow the installation instructions for Docker and Docker Compose.
Steps
1. Clone the Zango repository:
git clone https://github.com/Healthlane-Technologies/zango.git
cd zango
2. Run the following command from the root folder of the project:
python setup_project.py --project_dir <directory>
You can use the --build_core
option to build the Zango library. This creates a project named zango_project
in the zproject
folder in the specified directory.
3. Customize the project creation using optional arguments:
python setup_project.py --project_name my_project --project_dir /path/to/my_project --build_core --platform_username user@example.com --platform_user_password secret --skip_build_project
--project_name
: Modifies the name of the project (Default:zango_project
).--project_dir
: Specifies the directory for project creation (Default:zproject
).--build_core
: Builds the Zango library (Default:False
).--platform_username
: The user email of the platform user (Default:platform_admin@zango.dev
).--platform_user_password
: The password for the platform user (Default:Zango@123
).
4. Navigate to project_dir
to start the project.
5. Docker is started as a non root user, run the below commands to export the host UID and GID
export HOST_UID=$(id -u)
export HOST_GID=$(id -g)
6. Run docker compose up
in the project directory to start the project
After starting the Docker services, please wait a minute or two to ensure all services are fully up and running.
Once ready, you can access the platform in your browser at:
http://localhost:8000/platform
To log in to the platform, use the default credentials below or the credentials you specified when running the
python setup_project.py
command.
- Username:
platform_admin@zango.dev
- Password:
Zango@123