Redmine Geo-Task-Tracker (GTT) Plugin

The Geo-Task-Tracker (GTT) plugin adds spatial capabilities to Redmine:

• Locate your issues as point, line or polygon
• Show and filter issues on a map
• Specify a project area
• Store the location of a user
• Extends Redmine API
• Geocoding
• and more

Requirements

Redmine GTT plugins require PostgreSQL/PostGIS and will not work with SQLite or MariaDB/MySQL!!!

• Redmine 6.0 – 7.0 (CI-tested on 6.0, 6.1 and 7.0)
• Ruby >= 3.3 (Redmine 7.0: Ruby 3.4 or 4.0)
• PostgreSQL >= 15
• PostGIS >= 3.4
• NodeJS >= 22
• pnpm (via corepack enable pnpm; the version is pinned in package.json)

Installation

Create a PostGIS-enabled database:

createdb -U postgres -O redmine redmine
psql -U postgres -d redmine -c "CREATE EXTENSION postgis;"

To install Redmine GTT plugin, download or clone this repository in your Redmine installation plugins directory!

cd path/to/plugin/directory
git clone https://github.com/gtt-project/redmine_gtt.git
cd redmine_gtt
pnpm install
pnpm build

Alternatively, each GitHub release ships a prebuilt redmine_gtt-vX.Y.Z.tar.gz archive with the frontend assets already compiled, so no Node toolchain is needed:

tar -xzf redmine_gtt-vX.Y.Z.tar.gz -C path/to/plugin/directory/

Optionally export to override the default GEM version

export GEM_PG_VERSION=your-pg-version
export GEM_RGEO_ACTIVERECORD_VERSION=your-rgeo-activerecord-version
export GEM_ACTIVERECORD_POSTGIS_ADAPTER_VERSION=your-activerecord-postgis-adapter-version

Then run

bundle install
bundle exec rake redmine:plugins:migrate

Before restarting Redmine, you need to set postgis adapter instead of postgres adapter in your config/database.yml.

After restarting Redmine, you should be able to see the Redmine GTT plugin in the Plugins page.

More information on installing (and uninstalling) Redmine plugins can be found in the Redmine Plugin docs.

How to use

1. Go to plugin configuration for global settings
2. Configure at least one tile source
3. Enable GTT module in a project
4. Define the project boundary in GTT project settings
5. Create a new issue with a point, line or polygon

For more information with screenshots see the Getting Started guide.

Plugin API

For more information see the Redmine GTT API docs.

Contributing and Support

The GTT Project appreciates any contributions! Feel free to contact us for reporting problems and support.

Help us to translate GTT Project using OSGeo Weblate:

How to debug frontend

You can debug frontend by running the following command on another console:

pnpm watch

How to run test

Frontend unit tests (Vitest) run without a Redmine environment (install dependencies first if you haven't, see Installation):

pnpm install
pnpm test

The Ruby tests run on the Rails test environment:

bundle exec rake db:create
RAILS_ENV=test bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake redmine:plugins:migrate
RAILS_ENV=test NAME=redmine_gtt bundle exec rake redmine:plugins:test

Version History

See all releases with release notes.

Upgrading from 6.x to 7.0? See the migration guide.

Authors

• Jens Kraemer
• Daniel Kastl
• Thibault Mutabazi
• Ko Nagase
• Taro Matsuzawa
• Mario Basa
• Nisai Nob
• ... and others

LICENSE

This program is free software. See LICENSE for more information.