{"id":13449303,"url":"https://github.com/123andy/redcap-docker-compose","last_synced_at":"2026-01-18T11:22:53.325Z","repository":{"id":11714170,"uuid":"70339462","full_name":"123andy/redcap-docker-compose","owner":"123andy","description":"A docker compose project for running REDCap locally for development and testing","archived":false,"fork":false,"pushed_at":"2024-10-23T23:54:27.000Z","size":886,"stargazers_count":62,"open_issues_count":8,"forks_count":65,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-24T13:29:55.741Z","etag":null,"topics":["redcap","redcap-external-module"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/123andy.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}},"created_at":"2016-10-08T15:13:43.000Z","updated_at":"2024-10-23T23:54:32.000Z","dependencies_parsed_at":"2024-01-16T03:45:45.967Z","dependency_job_id":"da828061-5b54-4634-b3b2-bbaa8624fc22","html_url":"https://github.com/123andy/redcap-docker-compose","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/123andy/redcap-docker-compose","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/123andy%2Fredcap-docker-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/123andy%2Fredcap-docker-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/123andy%2Fredcap-docker-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/123andy%2Fredcap-docker-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/123andy","download_url":"https://codeload.github.com/123andy/redcap-docker-compose/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/123andy%2Fredcap-docker-compose/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28535162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T10:13:46.436Z","status":"ssl_error","status_checked_at":"2026-01-18T10:13:11.045Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["redcap","redcap-external-module"],"created_at":"2024-07-31T06:00:35.213Z","updated_at":"2026-01-18T11:22:53.298Z","avatar_url":"https://github.com/123andy.png","language":"PHP","funding_links":[],"categories":["Development \u0026 Testing Environments"],"sub_categories":[],"readme":"# REDCap Docker Compose Environment\n\n![Docker Compose][docker-compose-logo]\n![REDCap][redcap-logo]\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [About](#about)\n- [Features](#features)\n- [Quick-Start](#quick-start)\n- [Full Documentation](#full-documentation)\n- [Updates](#updates)\n- [License](#license)\n- [Contributing](#contributing)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n[![documentation-button](rdc/documentation/button_documentation.png)](rdc/documentation/README.md)\n\n\n## About\nThis repo is designed to build a local development instance of REDCap on your laptop.  It also includes a setup page to facilitate a rapid setup of REDCap using either your [consortium credentials](https://projectredcap.org/resources/community/) or a zip archive released by the REDCap team (that you might obtain from a collaborator at your institution).\n\nThis is intended to be one a rapid and easy way to run REDCap on your machine, be it a MAC, PC, or LINUX distribution.  It is also intended to be easily upgraded (e.g. change PHP version, change MYSQL version, etc..).  That said, it does use Docker - a technology for containerizing applications that may require some learning if it is new to you.\n\nThis is not intended to be used as a production server, although many institutions do run production services via docker containerized images.\nShould you want to run this in any 'exposed' server, be sure to edit the `redcap.ini` file in the `override-web/php` folder\nto have production-ready php settings.\n\n## Features\n * Mailpit to capture outbound email on your server for review\n * X-Debug support for detailed server-side inspection\n * PhpMyAdmin support for easy database maintenance / backups / restores (no longer active by default -- it has been replaced with Adminer - a simple script for doing basic database access)\n * Easy to modify php-version or mysql-version and rebuild your environment in minutes\n\n## Quick-Start\n * [Install Docker Desktop](https://docs.docker.com/get-started/get-docker/) (requires docker account which is free)\n * Download this repository and unzip it to your computer.  You can chose to use the [master branch](https://github.com/123andy/redcap-docker-compose/archive/master.zip) or you can pick a specific [release](https://github.com/123andy/redcap-docker-compose/releases).\n * Unzip the file to a good location (maybe `~/REDCap`) and open the directory using a good IDE, such as:\n [phpStorm](https://www.jetbrains.com/phpstorm/),\n [Visual Studio Code](https://code.visualstudio.com/),\n [Atom](https://atom.io/) - does not support xdebug, etc... )\n * Copy/Rename the `.env-example` to make a `.env` file - it is located in the `rdc` folder, next REVIEW the `.env` contents, making changes as necessary.\n * Once `.env` file settings are correct, from the `rdc` folder type `$ ~/REDCap/rdc\u003e docker compose up -d`\n * Open your web browser and goto `http://localhost` (or, in some cases with macs `http://127.0.0.1`) and follow\n  directions for further installation\n\n:warning: **If you have a previous version of redcap-docker-compose make sure you change the `DOCKER_PREFIX` variable otherwise you may corrupt your existing installation.  Please see the full docs for more detail**\n\n## Upgrading The Framework\nIf you have an existing REDCap Docker Compose development setup and wish to switch to the latest version, please review\nthe section in the [detailed documentation](rdc/documentation/README.md#how-do-i-upgrade-to-the-latest-version-of-redcap-docker-compose)\n\n## Full Documentation\nSee the [detailed documentation](rdc/documentation/README.md) for more information!  Keep in mind this is a community\neffort so feedback is appreciated.  Please create issues here with any suggestions or make a pull request with improvements.\n\n## Updates\n* 2025-02-18  Added composer and npm/node to web container for facile unit testing\n* 2024-10-23  Added instructions for setting up local SSL environment, cleaned up vhost setups\n* 2024-10-21  Upgraded to php 8.3 and added [adminer](rdc/documentation/README.md#adminer) as alternate db access tool, and commented out phpMyAdmin by default\n* 2024-10-17  Replaced mailhog with mailpit - a supported variant to handle mail better\n* 2022-10-06  Did some cleanup to allow for M1 (ARM) support and Intel without changes\n* 2022-02-16  Made defaults php 8.1, mysql 8.0, xdebug 3.1.3 and incorporated some pull requests\n* 2020-12-28  Made defaults php7.4, xdebug 3.0, mysql 8\n* 2020-09-24  Minor documentation cleanup and testing for Windows\n* 2019-10-03  Improved documentation and cleanup of unused settings (issue #4)\n* 2019-09-06  Removed ssmtp and replaced with msmtp\n* 2019-06-06  Add X-Debug configuration.\n* 2019-01-24  Changed folder layout and optimized unzipping after upload to be much faster\n* 2018-08-19  Added .env file and added UID override for MAC users to maintain file ownership (see .env)\n* 2018-08-04  Added support for auto-install from `redcapx.y.z.zip`\n* 2018-08-01  Major refactoring into docker-compose 3\n\n## License\nCopyright (c) 2024 Andrew Martin\nLicensed under the MIT license.\n\n## Contributing\nPlease make pull requests to extend the functionality and documentation\n\nI'd like to thank the many people who have contributed to making this repo better!\n\n[redcap-logo]: rdc/documentation/redcap-logo-large.png \"REDCap\"\n[docker-compose-logo]: rdc/documentation/docker-compose.png \"Docker Compose\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F123andy%2Fredcap-docker-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F123andy%2Fredcap-docker-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F123andy%2Fredcap-docker-compose/lists"}