Install instructions


  • You need docker installed. Compose plugin is recommended in the configuration below.

    See Docker.

  • Optional : if you want to use external database, prepare a postgresql 11+ (15 recommended) postgis2.5 (3.3 recommended) database with postgis enabled, and a dedicated user.

    You can use external database by commenting postgres container and volume references in docker-compose.yml, and set variables in your conf/visu.env file :





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 terra_visu
  • Prepare environment variables


    -> Set or change all required values

at least:

  • ALLOWED_HOST # list of your final host(s), comma separated values

  • SECRET_KEY # unique key for your project. See

  • POSTGRES_USER # a dedicated user for your database

  • POSTGRES_PASSWORD # a dedicated password for your database

  • Pull images

    docker compose pull
  • 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 project/fixtures/initial.json
  • Launch stack

    docker compose up -d
  • … and access to TerraVisu


You can change port mapping by using a .env file in terra_visu directory :

# .env


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

  • Backup your data (database, public/media and var/ folder)

  • Pull latest image

    docker compose pull
  • Run post update script

    docker compose run --rm web
  • Relaunch your stack

    docker compose down
    docker compose up -d