README.md

Open Hospital

Open Hospital is a free and open-source Health Information Management System (HIMS) software application.

This repository is used to assemble the portable (or all-in-one) packages of Open Hospital, which you can download also here.

Download

[Download latest release from github] [ All releases ]

[Download latest release from sourceforge] [ All releases ]

Download stats

Software

Open Hospital (OH) is deployed as a desktop application that can be used in a standalone, single user mode (PORTABLE mode) or in a client / server network configuration (CLIENT mode), where multiple clients and users connect to the same database server. OH is developed in Java and it is based on open-source tools and libraries; it runs on any computer, requires low resources and is designed to work without an internet connection. For more information check the online documentation here.

Open Hospital is composed by the following components, hosted in separated repositories:

• OH CORE, a library that contains the business logic and the data abstraction layer
• OH GUI, which provides a graphical user interface (GUI) made with Java Swing
• OH DOC, which contains the user and admin documentation in Asciidoc format
• OH API, a web server that exposes REST APIs over the Core component, and it's used by the UI component [WIP].
• OH UI, a web user interface that consists of a React SPA (single page application) [WIP]

How to contribute

There are several ways in which you can contribute to Open Hospital:

• try the desktop application or the early versions of the web UI
• request new features or report issues on JIRA (here's a list of good-first-issues)
• improve the documentation
• contribute code patches to one of the components

Documentation

Read on about Open Hospital:

• on the official website
• user and admin manuals
• wiki
• FAQ

Community

You can reach out to the community of contributors by joining our Slack workspace or by subscribing to our mailing list.

How to create OH packages

👷 📦

To create the Open Hospital packages, make sure to have installed the following dependencies on a Linux machine: JDK 8+, Maven, asciidoctor-pdf, zip, GNU make.

Then follow these simple steps:

1. Clone this repository:

   git clone https://github.com/informatici/openhospital
   

2. Run the script that compiles the components of Open Hospital, and assembles the portable distributions:

   cd openhospital
   make
   

   You can also parallelize some make tasks by using the -j flag (e.g. make -j4) or use intermediate targets to build single parts of the distribution - use make help to see a list of available targets.