gaiaDocker

Description

gaiaDocker provides containerized deployment orchestration for the complete Gaia toolchain. It coordinates image builds, manages versioned releases, and enables consistent deployment across development, testing, and production environments.

Key Features

  • Complete stack deployment with a single command
  • Profile-based configuration (gaia, degauss) for flexible deployments
  • Coordinated versioning across all Gaia components
  • Persistent data storage for databases and search indexes
  • Service orchestration via Docker Compose
  • OHDSI Broadsea integration for broader ecosystem compatibility

Services Managed

gaiaDocker orchestrates the following services: - gaia-db: PostgreSQL/PostGIS database (gaiaDB) - gaia-core: RStudio with HADES and the gaiaCore R package (image ohdsi/gaia-core) - gaia-postgrest: optional PostgREST API service - gaia-catalog: Flask catalog interface - gaia-solr: Solr search engine - gaia-osgeo: GDAL/OGR ETL tools - gaia-postgis: PostGIS-specific ETL tools - gaia-degauss (optional): Geocoding service

Platforms

The reference deployment uses Docker Compose. It has been deployed on Linux and macOS, and a default Windows 11 deployment has run the tutorial pipeline. It needs Docker, Docker Compose and about 50 GB of free storage (more if you add geocoding reference data). Docker is a convenience, not a requirement: gaiaDB is a standard PostgreSQL/PostGIS database that runs on any native Postgres server, and gaiaCore can be pointed at any gaiaDB instance.

Quick Start

git clone https://github.com/OHDSI/gaiaDocker.git
cd gaiaDocker
docker compose --profile gaia up -d

Pinned images for the tutorial

For the tutorial, a Compose override file pins the services of the gaia profile (database, PostgREST, catalog, Solr and pgAdmin) to specific image versions so everyone runs exactly the same stack. See Get Started for the command and the tutorial checklist for the pinned R image.