open-termhub

Open source FHIR® terminology server deployable as a docker container with local sandbox terminology data provided for testing. This runtime container works seamlessly with terminology content provided by TermHub which has a library of code systems, value sets, and concept mappings.

Video Overview of Open TermHub

Table of Contents

1. Step-by-step instructions with Sandbox data
2. Step-by-step instructions with Sandbox data using syndication
3. Step-by-step instructions to Deploy Terminologies with TermHub

Other Resources

• FAQ - Frequently Asked Questions
• More details on building and deploying with real data
• Docker image and environment variables

Configuration highlights

Common environment variables (full list in DEPLOY.md and DOCKER.md):

• READ_ONLY=true — rejects HTTP APIs that add, alter, or remove content (403) and disables startup/cron syndication. Read APIs (including FHIR $ operations and POST /concept/bulk) remain available at runtime. Swagger/OpenAPI hides DELETE, PUT, PATCH, and POST operations.
• ENABLE_POST_LOAD_COMPUTATIONS — enable tree-position computations used by the hierarchy browser (default: false).
• PROJECT_API_KEY / ADMIN_KEY — required for TermHub syndication and protected local admin endpoints.

Contributing

1. Build and Test
2. Docker Image
3. Fork it!
4. Create your feature branch: git checkout -b my-new-feature
5. Commit your changes: git commit -am 'Add some feature'
6. Push to the branch: git push origin my-new-feature
7. Submit a pull request

Back to top

Current Contributors

• Brian Carlsen
• Other Contributors

Back to top

License

See the included LICENSE.txt file for details.

Back to top