Stratafy mining information portal

Stratafy Deployment

1. Prerequisites

• Docker & Docker Compose v2
• GNU Make
• Git (with submodule support)

2. Clone & Configure

git clone git@github.com:kartoza/Stratafy.git
cd Stratafy/deployment
cp .template.env .env
cp docker-compose.override.template.yml docker-compose.override.yml
# Edit .env to set DB creds, CESIUM_TOKEN, SITE_PUBLIC_URL, etc.

3. Development Setup

make build-dev
make dev
# Wait for DB to be ready, then:
make migrate
# (Optional)
make createsuperuser

4. Production Setup

make build
make up-all
make migrate
make collectstatic
make createsuperuser

5. Common Tasks

• View logs: make logs or make tail APP=django
• Rebuild & restart after code changes: make build && make restart APP=django
• Scale workers: docker compose up -d --scale worker=4 worker

6. Backups

make backup-db
# To restore:
make restore-db FILE=backups/backup-YYYY-MM-DD-HHMM.sql.gz

7. Trobleshooting

• Check container status: make ps
• Inspect specific logs: make tail APP=geoserver
• Verify DB readiness: make wait-for-db
• Clear Celery queue: stop worker, purge in RabbitMQ management (if enabled)