Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3


  1. New to OpenMRS sprints? Want help getting started? Join the ?the IRC channel and say "???": I'd like to participate in the sprint!"
  2. Checkout code:
    1. Fork 
    2. Clone your fork: git clone
    3. Add upstream: git remote add upstream
    4. Fetch all branches: git fetch --all
    5. Checkout the sprint branch: git checkout sprint-201302
  3. Compile code:
    1. Run: mvn clean install
  4. Setup OpenMRS. Get  the standalone:
    1. Unpack and start openmrs-standalone.jar. Choose the demo database.
    2. Go to http://localhost:8081/openmrs-standalone/admin/modules/module.list and upload a compiled omod, which you can find in
  5. Pick a ticket from the available tickets in the top-left of the sprint dashboard page (listed below). Make sure it does not depend on a ticket that is incomplete. If you have any questions about the ticket, ask on the group chat
  6. Create a local branch for your ticket (see also our HOWTO for git, use 'sprint-201302' instead of 'master')
    1. git checkout -b REPORT-123 sprint-201302
    2. git push origin REPORT-123
  7. Do the ticket.
    1. Stage changes: git add -i
    2. Commit: git commit -m "REPORT-123: ticket title"
    3. Push changes: git push -f
  8. Issue a pull request for the 'sprint-201302' branch (see github help) or if you have push rights: whatever works for you! If you don't like pull requests, don't send them. Commit and push directly to the upstream repo. If you do like pull requests, fork the repo and send pull requests, but merge them right after. My favorite way is to work on the repo, but create local branches (without pushing them to the repo). Merge branches locally to the sprint branch and push to the repo.
  9. If you push directly to the repo check if tests for the sprint branch in reporting are passing: (Favorite the branch to be notified about failures: Login into Bamboo, Choose Actions -> Favorite Branch)
  10. Join the daily scrum to share your updates


Wiki Markup