{"id":13627030,"url":"https://github.com/markaspot/mark-a-spot","last_synced_at":"2025-04-16T19:31:09.625Z","repository":{"id":3607668,"uuid":"4672525","full_name":"markaspot/mark-a-spot","owner":"markaspot","description":"Public Civic Issue Tracking and Crowdsourcing / Mapping Platform based on Drupal. Open311 Server and Client Software","archived":false,"fork":false,"pushed_at":"2025-04-10T13:59:34.000Z","size":59029,"stargazers_count":58,"open_issues_count":1,"forks_count":30,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-10T14:59:12.454Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://mark-a-spot.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markaspot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-06-15T07:26:59.000Z","updated_at":"2025-04-10T13:58:58.000Z","dependencies_parsed_at":"2022-09-11T00:22:48.874Z","dependency_job_id":"e2149cbd-bbef-4679-a271-f90c3bbff68b","html_url":"https://github.com/markaspot/mark-a-spot","commit_stats":{"total_commits":247,"total_committers":5,"mean_commits":49.4,"dds":"0.15384615384615385","last_synced_commit":"283524cff1cfb20da632e5bbcbeb9c03a6f3b3ae"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markaspot%2Fmark-a-spot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markaspot%2Fmark-a-spot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markaspot%2Fmark-a-spot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markaspot%2Fmark-a-spot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markaspot","download_url":"https://codeload.github.com/markaspot/mark-a-spot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249268549,"owners_count":21240941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T22:00:29.230Z","updated_at":"2025-04-16T19:31:04.614Z","avatar_url":"https://github.com/markaspot.png","language":"TypeScript","funding_links":[],"categories":["Mobile apps","Software"],"sub_categories":["Cities"],"readme":"# Mark-a-Spot Drupal Docker Setup\n\nMark-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.\n\n## Getting Started\n\nThese instructions will guide you through getting a copy of the project up and running on your local machine for development and testing purposes.\n\n### Prerequisites\n\n- Docker\n- Docker Compose\n\n### Installation\n\n1. Clone this repository:\n    ```bash\n    git clone https://github.com/markaspot/mark-a-spot.git\n    cd mark-a-spot\n    ```\n\n2. Run the Docker containers:\n    ```bash\n    docker-compose up -d\n    ```\n\n3. Run the `start.sh`script\n   If it gives you an error of permission denied make it executable with: `chmod a+x ./scripts/start.sh`)\n    ```bash\n   docker exec -it markaspot ./scripts/start.sh -y\n    ```\n   The `start.sh` script has two options:\n   - `-y` For automatic installation with predefined values (latitude: 40.73, longitude: -73.93, city: New York, locale: en_US)\n   - `-t` To import translation file from the `/translations` directory and enable translations for terms\n\nOnce the script has executed, the application should be accessible at http://localhost. Please exercise caution when executing the script, as it will drop the database and initialize Mark-a-Spot from scratch. Additionally, familiarize yourself with the Drupal development process, including configuring changes, backing up databases, and other relevant procedures.\n\n### Services\n\nThe Docker Compose setup includes the following services:\n\n- `web`: The Nginx web server\n- `markaspot`: The Mark-a-Spot Drupal application\n- `db`: The MariaDB database\n- `phpmyadmin`: PHPMyAdmin for database management\n\n### Configuration\n\nYou 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.\n\n## Usage\n\nAccess the Drupal application at `http://localhost`.\n\nPHPMyAdmin is available at `http://localhost:8080` for database management.\n\n## Development\n\nFor local development, we recommend using [Docksal](https://docksal.io/), a Docker-based development environment.\n\n### Prerequisites\n\n- Docksal\n- Docker\n- Docker Compose\n\n### Installation\n\n1. Install Docksal on your machine, following the instructions on the [Docksal website](https://docksal.io/installation).\n\n2. Clone this repository:\n\n    ```bash\n    git clone https://github.com/markaspot/mark-a-spot.git\n    cd mark-a-spot\n    ```\n\n3. Initialize the Docksal project:\n\n    ```bash\n    fin up\n    ```\n4. Copy the local settings file to the web sites default directory and change your settings.php\n\n    ```bash\n    cp web/sites/example.settings.local.php web/sites/default/settings.local.php\n    ```\n5. Swap drush version as long https://github.com/docksal/docksal/issues/1783 is not solved:\n\n    ```bash\n    fin bash\n    echo -e \"\\n\"'export PATH=\"${PROJECT_ROOT:-/var/www}/vendor/bin:$PATH\"' \u003e\u003e $HOME/.profile;\n    source $HOME/.profile\n    ```\n6. Run `scripts/start.sh` in docksal CLI (see above)\n\n\n### Configuration\n\nYou 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.\n\n### Usage\n\nYou can access the Drupal application at `http://mark-a-spot.docksal.site`.\n\n## License\n\nMark-a-Spot is freely available under the [GNU General Public License, version 2 or any later version](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) license.\n\n\n[![Docker Image CI](https://github.com/markaspot/mark-a-spot/actions/workflows/docker-image.yml/badge.svg)](https://github.com/markaspot/mark-a-spot/actions/workflows/docker-image.yml)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkaspot%2Fmark-a-spot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkaspot%2Fmark-a-spot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkaspot%2Fmark-a-spot/lists"}