Administrator Guide¶

This guide covers the installation, configuration, and maintenance of Cloud Native GIS.

Overview¶

Cloud Native GIS is a Django-based platform that can be deployed as:

A standalone application using Docker
A Django library integrated into existing projects

Sections¶

Deployment - Installation and deployment options
Configuration - Environment variables and settings
Maintenance - Backup, monitoring, and troubleshooting

System Requirements¶

Minimum Requirements¶

Component	Requirement
CPU	2 cores
RAM	4 GB
Storage	20 GB SSD
OS	Linux (Ubuntu 22.04+, Debian 11+)

Recommended Requirements¶

Component	Requirement
CPU	4+ cores
RAM	8+ GB
Storage	100+ GB SSD
OS	Linux with Docker

Software Dependencies¶

Python: 3.10, 3.11, or 3.12
PostgreSQL: 13+ with PostGIS 3.0+
Docker: 20.10+ (for containerized deployment)
Node.js: 18+ (for frontend development)

Quick Start¶

Docker Deployment¶

# Clone the repository
git clone https://github.com/kartoza/CloudNativeGIS
cd CloudNativeGIS

# Configure environment
cp deployment/.template.env deployment/.env
cp deployment/docker-compose.override.template deployment/docker-compose.override.yml

# Edit .env with your settings
nano deployment/.env

# Start the application
make up

Django Library Installation¶

pip install cloud-native-gis

Add to your Django settings:

INSTALLED_APPS = [
    # ...
    'cloud_native_gis',
    # ...
]

Add to your URLs:

urlpatterns = [
    # ...
    path('', include('cloud_native_gis.urls')),
]

Security Considerations¶

Change default credentials immediately after installation
Use HTTPS in production
Configure CORS appropriately for your domain
Set secure environment variables (see Configuration)
Regular security updates for all dependencies

Support¶

Made with by Kartoza | Donate! | GitHub