Install local Environment


  • Configuration

To get local environment working, we recommend to use a custom domain, as ‘georiviere.local’. Define it in your /etc/hosts.

Copy the env dist file

cp .env.dist .env

Set required values, for postgres database access

  • Init database:

docker-compose run --rm web ./ migrate
  • Create user:

docker-compose run --rm web ./ createsuperuser
  • Run:

docker-compose up


  • Launch tests :

docker-compose run --rm web ./ test
  • With coverage :

docker-compose run --rm web coverage run ./ test
docker-compose run --rm web coverage report -m


  • Manage all project dependencies with pip-tools

  • Use included pip-tools to generate requirements (python version should match georiviere version)

Global dependencies:

Set global dependency in

docker-compose run --rm web pip-compile

pip-tools does not upgrade any package by default. Package is upgrade only if new dependency require another version that already fixed in requirements.txt file.

To upgrade a package, run:

docker-compose run --rm web pip-compile --upgrade-package django==3.1.*

Development packages are separated in dev-requirements.txt depends on requirements.txt.

docker-compose run --rm web pip-compile


Geotrek is used as main library of this project. Sub-dependencies are not yet managed in geotrek When you update geotrek, you should update requirements according geotrek dependencies versions.