GNU Health/Embedded

From Wikibooks, open books for an open world
Jump to navigation Jump to search
GNU Health embedded on a Raspberry Pi3 and OpenSUSE tumbleweed.

The GNU Health Embedded sub-project ("GNU Health in a Box") focuses on the installation and use of GNU Health in single-board devices.

The use of GNU Health in single board devices such as Raspberry Pi has many advantages (in addition to the low cost) such as the easy deployment, little maintenance and low energy consumption that makes it a candidate for some of the following scenarios :

  • Remote areas without Internet
  • Academic Institutions
  • Domiciliary Units
  • Vector Control
  • Nursing
  • ICU
  • Laboratory stations
  • Personal Health Records

The device is a full server, that has its own database, allowing storing the information locally, without the need of a network. That said, keep in mind that it is a low-resource device, so it's usage must be carefully planned, and it's not suitable for high-demand, heavy load environments, where a regular server would be needed.

Raspberry Pi[edit]

Currently we are working on the Raspberry Pi 3 platform. The SD image includes the following functionality :

  • Operating System : OpenSUSE Tumbleweed
  • Linux Kernel 4.14
  • PostgreSQL 10
  • GNU Health server 3.2
  • Secure Shell (SSHD)
  • Desktop Environment : XFCE

The images of GNU Health for the Raspberry Pi 3 come in a single file, Clonezilla image. Please note that the GNU Health embedded images are not "Live CDs" or other generic installation media. The GNU Health embedded images are working operating systems with modules, users, database engine and GNU Health services pre-installed, and ready to run. They are highly-specific in terms of architecture and hardware.

Getting the Image[edit]

You can get the latest status and download packages on the GNU health main site, under the section "GNU Health Embedded".

Main users[edit]

The two main OS users are :

- root : default password "linux" (as in OpenSUSE)

- gnuhealth : The GNU Health admin. Default password "freedom"

The GNU Health Service[edit]

The GNU Health Hospital Management System is active by default. You can execute the following actions, either as root or as the GNU Health administrator (gnuhealth)

  • Start : Boots the instance.
systemctl start gnuhealth
  • Restart : Restart the server.
systemctl restart gnuhealth
  • Stop : Shutdown the GNU Health server.
systemctl stop gnuhealth
  • Status : Check the current status of the sever .
systemctl status gnuhealth

Enabling the Graphical Interface[edit]

GNU Health embedded on a Raspberry Pi3 - XFCE desktop environment on OpenSUSE Tumbleweed

GNU Health embedded can run both in text an graphic mode. In order to save resources, specially memory, the graphical interface is disabled by default. If you want to activate it, you can do so as root.

systemctl start display-manager

Loading the demo database[edit]

GNU Health embedded ships with the demo database postgres dump, so it can be installed locally. To do so, execute the following steps :

1) Login as "gnuhealth" user

2) Run the script ""

cd $HOME

This script will reset and create the "health32" database, with the demo GNU Health instance as in the community server. Warning ! This action will delete and recreate the "health32" database !