Install instructions

Requirements

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

    • 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

    wget https://github.com/Georiviere/Georiviere-admin/releases/latest/download/install.zip

  • Unzip it where you want

    unzip install.zip
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/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/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

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