Prerequisites
A Zango Project is your main project under which you can create, develop, and host multiple apps on the same infrastructure. Zango uses django-tenants to isolate applications at the database level.
Think of it as your own private app ecosystem, where each application maintains its isolation while benefiting from shared resources and infrastructure.
Pre-requisites
There are a few requisites that need to be completed before you start creating a Zango project. If you already have them configured, move straight to Creating a Zango Project.
1. PostgreSQL Database Setup
- Docker
- Manual
Installing and setting up a PostgreSQL database manually can be overwhelming. If you have Docker installed, you can set it up in just 3 commands:
1. Pull the Postgres Docker Image
docker pull postgres
2. Create a Docker Volume
docker volume create postgres_data
3. Run the Postgres Docker Container
docker run --name postgres_container -e POSTGRES_PASSWORD=mysecretpassword -d -p 5432:5432 -v postgres_data:/var/lib/postgresql/data postgres
After setup, the DB configuration values for .env will look like:
POSTGRES_DB=postgres
POSTGRES_USER=postgres
POSTGRES_PASSWORD=mysecretpassword
POSTGRES_HOST=127.0.0.1
POSTGRES_PORT=5432
To get started, follow these steps to set up a PostgreSQL database:
-
Install PostgreSQL — download the installer for your platform from the official website.
-
Create a Fresh Database — once PostgreSQL is installed, open your terminal or a PostgreSQL client and run:
createdb your_database_name
Ensure that the newly created database is fresh without any existing tables or data.
The exact steps for installing PostgreSQL may vary depending on your operating system. Consult the PostgreSQL documentation for your specific platform if you encounter any issues during installation.
2. Redis Setup
Redis is used as a broker by Celery workers.
- Docker
- Manual
Run Redis inside a Docker container on port 6379:
docker run --name "name" -d -p 6379:6379 redis
For example:
docker run --name zango_redis -d -p 6379:6379 redis
Ubuntu/Debian Linux
# Step 1: Update package list
sudo apt update
# Step 2: Install Redis
sudo apt install redis-server
# Step 3: Start Redis service
sudo systemctl start redis-server
# Step 4: Enable Redis to start on boot
sudo systemctl enable redis-server
# Step 5: Verify installation
redis-cli ping # Should return "PONG"
macOS (using Homebrew)
# Step 1: Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Step 2: Install Redis
brew install redis
# Step 3: Start Redis
brew services start redis
# OR run without service
redis-server
# Step 4: Verify installation
redis-cli ping
From Source (Any Linux/Unix system)
# Step 1: Install dependencies
sudo apt install build-essential tcl # For Ubuntu/Debian
# OR
sudo yum groupinstall "Development Tools" # For RHEL/CentOS
# Step 2: Download Redis
wget https://download.redis.io/redis-stable.tar.gz
# Step 3: Extract the archive
tar xzf redis-stable.tar.gz
# Step 4: Enter directory
cd redis-stable
# Step 5: Compile
make
# Step 6: Install
sudo make install
# Step 7: Create directories and copy config
sudo mkdir /etc/redis
sudo cp redis.conf /etc/redis
# Step 8: Start Redis
redis-server
# Step 9: Verify installation
redis-cli ping
With PostgreSQL and Redis running, you're ready to create your first Zango project.
Create your Zango project →