Mark-a-Spot is an open-source Civic Issue Tracking and Open311 Server built on Drupal CMS. This repository provides a Docker setup to facilitate running Mark-a-Spot.

These instructions will guide you through getting a copy of the project up and running on your local machine for development and testing purposes.

• Docker
• Docker Compose

1. Clone this repository:

   git clone https://github.com/markaspot/mark-a-spot.git
   cd mark-a-spot

2. Build and run the Docker containers:

   docker-compose up -d
   docker exec -it markaspot ./scripts/start.sh

   The start.sh script has two options:

   • -y For automatic installation with predefined values (latitude: 40.73, longitude: -73.93, city: New York, locale: en_US)
   • -t To import translation file from the /translations directory and enable translations for terms

After running these commands, you should be able to access the application at http:https://localhost.

The Docker Compose setup includes the following services:

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

You can adjust the configuration of the Docker services by editing the docker-compose.yml file. For example, you can modify the database username and password, the PHP memory limit, and other settings.

Access the Drupal application at http:https://localhost.

PHPMyAdmin is available at http:https://localhost:8080 for database management.

For local development, we recommend using Docksal, a Docker-based development environment.

• Docksal
• Docker
• Docker Compose

1. Install Docksal on your machine, following the instructions on the Docksal website.

2. Clone this repository:

   git clone https://github.com/markaspot/mark-a-spot.git
   cd mark-a-spot

3. Initialize the Docksal project:

   fin up

4. Copy the local settings file to the web sites default directory:

   cp conf/settings.local.php web/sites/default/

5. Swap drush version as long docksal/docksal#1783 is not solved:

   fin bash
   echo -e "\n"'export PATH="${PROJECT_ROOT:-/var/www}/vendor/bin:$PATH"' >> $HOME/.profile;
   source $HOME/.profile

6. Run scripts/start.sh in docksal CLI (see above)

Copy the conf/settings.local.php into web sites default directory You can adjust the configuration of the Docker services by editing the docksal.yml file. For example, you can modify the database username and password, the PHP memory limit, and other settings.

You can access the Drupal application at http:https://mark-a-spot.docksal.site.

Mark-a-Spot is freely available under the GNU General Public License, version 2 or any later version license.