Skip to content

Run Locally

Download and start

Running the Ozone demo locally takes just three terminal commands:

curl -s https://raw.githubusercontent.com/ozone-his/ozone/main/scripts/install-stable.sh | bash /dev/stdin
cd ozone/run/docker/scripts/
./start-demo-with-sso.sh

It may take some time to download and setup Ozone for the first time.

Browse

Once started, the script will output the URLs to access the HIS apps and services:

For example:

Ozone services started

Accessing any of those URLs should present you the Single Sign-On portal page:

SSO login page

Log in to the demo using username jdoe and password password.

You're ready to start browsing Ozone 👏 !

🛠️ If you encounter an error when trying to access OpenMRS specifically, you may need to apply the following command to force a restart of the OpenMRS service.

docker restart ozone-openmrs-1

Shut down the server

Once you're done browsing Ozone, you can destroy the server to keep your environment clean.

./destroy-demo.sh