Install instructions


  • You need docker installed. Docker-compose is recommended in the configuration below.

    See Docker and Docker compose install documentations.

  • Optional : if you want to use external database, prepare a postgresql 10+ postgis2.5+ database with postgis and postgis_raster 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

  • Pull images

      docker-compose pull
    (Use `docker compose` if docker-compose version is >=2.4.x)
  • 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/**/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