Mark-a-Spot
Tutorial·

How to Install Mark-a-Spot with Docker

A deep dive into the Mark-a-Spot Docker setup for development and testing. Get the open-source 311 platform running locally in minutes.
Author avatar Holger Kreis

Mark-a-Spot is an open-source platform for citizen issue tracking and an Open311 server based on the Drupal CMS. The GitHub repository provides a Docker setup to make running Mark-a-Spot easier.

Getting Started

This guide walks you through setting up a local Mark-a-Spot project for development and testing.

Prerequisites

  • Docker: A platform for containerizing applications.
  • Docker Compose: A tool for defining and running multi-container Docker applications.

Installation Steps

  1. Clone the repository:
git clone https://github.com/markaspot/mark-a-spot.git
cd mark-a-spot
  1. Start Docker containers:
docker-compose up -d
  1. Run the start script:
docker exec -it markaspot ./scripts/start.sh

The script offers two options:

  • -y: Automatic installation with predefined values (New York, USA)
  • -t: Imports translation files and activates term translations.

After running the script, the application is accessible at http://localhost.

Docker Services

The Docker Compose setup includes:

  • web: The Nginx web server
  • markaspot: The Mark-a-Spot Drupal application
  • db: The MariaDB database
  • phpmyadmin: PHPMyAdmin for database management

License

Mark-a-Spot is licensed under the GNU General Public License, version 2 or later.

Mark-a-Spot as Leading Open-Source Civic Issue Tracker: Insights from Academic Research

A research paper by Haas and Knoch compares FixMyStreet, Mark-a-Spot, and Klarschiff. Mark-a-Spot stands out for usability and flexible configuration.