Install instructions


  • You need docker installed on your system.

    See Docker install documentations.

  • Optional : if you want to use external database, prepare a postgresql 10+ postgis2.5+ database with postgis, postgis_raster and unaccent enabled, and a dedicated user.

    You can use external database by commenting postgres container and volume references in docker-compose.yml, and set variables :

    • PGPORT




Add local IPs in pg_hba.conf to allow connection from docker containers to your database.

  • You can use external nginx proxy. Edit provided nginx conf file and comment nginx references in docker-compose.yml. Fix web:8000 to in nginx.conf.


  • Download zip package

  • Unzip it where you want

    cd georiviere
  • Prepare environment variables

    mv .env.dist .env

    -> Set all required values in this file. SERVER_NAME should match IP address or domain used by web browsers.

  • Pull images

    docker compose pull
  • Init default var folder

    docker compose run --rm web bash -c "exit"
  • Set at least these variables in var/conf/
    • SRID



    As geotrek overlay, these settings should be set BEFORE database initialization. See Basic settings for details

  • Init database and project config

    docker compose run --rm web
  • Create your super user

    docker compose run --rm web ./ createsuperuser
  • Load initial data

    docker compose run --rm web ./ loaddata georiviere/contribution/fixtures/basic.json georiviere/description/fixtures/basic.json georiviere/finances_administration/fixtures/basic.json georiviere/knowledge/fixtures/basic.json georiviere/main/fixtures/basic.json georiviere/maintenance/fixtures/basic.json georiviere/observations/fixtures/basic.json georiviere/proceeding/fixtures/basic.json georiviere/river/fixtures/basic.json georiviere/studies/fixtures/basic.json georiviere/valorization/fixtures/basic.json
  • Launch stack

    docker compose up -d


  • Read release notes about bugfix, news and breaking changes.

  • Backup your data (database and var folder)

  • Pull latest image

    docker compose pull
  • Run post update script

    docker compose run --rm web
  • Relaunch you docker-compose stack

    docker compose down
    docker compose up -d