ohif/app repository overview

⁠The OHIF Viewer

The Open Health Imaging Foundation (http://ohif.org/⁠) provides a general purpose web-based DICOM Viewer which can be easily extended for specific uses.

• See https://docs.ohif.org/⁠ for more information.
• Full source code is available at https://github.com/OHIF/Viewers/⁠ under the MIT License.

⁠Docker Image Versioning and Tags

⁠latest and latest-beta Tags

• latest: Points to the most recent stable release of the application. It is ideal for production environments where stability and reliability are critical.
• latest-beta: Points to the most recent beta release, designed for testing new features and updates before they are included in the stable version.

⁠Versioning and Tagging Strategy

⁠1. Semantic Versioning

We follow semantic versioning (e.g., vX.Y.Z):

• X: Major version for significant changes or breaking updates.
• Y: Minor version for backward-compatible feature additions.
• Z: Patch version for bug fixes and minor improvements.
  Example: ohif/app:v3.6.1 represents version 3.6 with the first patch update.

⁠2. Platform-Specific Tags

Our images are tagged for specific architectures:

• AMD64: ohif/app:v3.6.1-amd64
• ARM64: ohif/app:v3.6.1-arm64

⁠3. Multi-Architecture Manifests

• Combined tags allow pulling the correct image for the user's platform automatically:
  • Example: ohif/app:v3.6.1 will resolve to amd64 or arm64 based on the platform.

This strategy ensures flexibility, reliability, and clarity for users across stable and beta releases on multiple architectures.

⁠Running the OHIF Viewer Using Docker

To deploy the OHIF Viewer via Docker, follow these steps:

1. Pull the Desired Image:

   • For the latest stable release:

     docker pull ohif/app:latest
     

     Copy
   • For the latest beta release:

     docker pull ohif/app:latest-beta
     

     Copy

2. Run the Docker Container: Execute the following command to start the OHIF Viewer:

   docker run -d -p 3000:80 --name ohif-viewer ohif/app:latest
   

   Copy
   • Flags:
     • -d: Runs the container in detached mode.
     • -p 3000:80: Maps port 80 in the container to port 3000 on your host machine.
     • --name ohif-viewer: Assigns the name "ohif-viewer" to the container.

3. Access the OHIF Viewer: Once the container is running, navigate to http://localhost:3000 in your web browser to access the OHIF Viewer.

For more detailed information and advanced configuration options, refer to the official OHIF Docker deployment documentation.