Install instructions

Requirements

  • 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, 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 :
    • POSTGRES_HOST

    • PGPORT

    • POSTGRES_USER

    • POSTGRES_PASSWORD

    • POSTGRES_DB

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 127.0.0.1:8000 in nginx.conf.

Install

  • Download zip package

  • Unzip it where you want

    unzip install.zip
    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/custom.py:
    • SRID

    • DEFAULT_STRUCTURE_NAME

    • SPATIAL_EXTENT

    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 update.sh
    
  • Create your super user

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

    docker-compose run --rm web ./manage.py loaddata georiviere/**/fixtures/basic.json
    
  • Launch stack

    docker-compose up -d
    

Update

  • 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 update.sh
    
  • Relaunch you docker-compose stack

    docker-compose down
    docker-compose up -d