xrysanthos / openreferral-playground

Open Referral - Playground reference app
MIT License
7 stars 3 forks source link
docker human-services human-services-data-specification nodejs openreferral

OpenReferral Playground

Collection of OpenReferral tools bundled in a self standing application.

Running locally

In order to run the project you need to have the latest NodeJS and npm installed.

Once your environment is all set up, clone the repository, go into the root directory and install all dependencies by running

$ npm install

Once all the dependencies have been downloaded, run the application with

$ npm start

This will launch the NodeJS application and it will be available at http://localhost:8080 in your browser.

Running as a Docker container

You need to have Docker service installed on your local machine or any other target host.

Once Docker is installed, fetch the latest image from the Docker Hub registry

$ docker pull openreferral/playground

Then fire up a Docker container instance by entering

$ docker run -d -p 8080:8080 --net=host --name="playground" openreferral/playground

You can use any name you want, by replacing the "playground" value with one of your choice. The container will bind the 8080 port by default so if you want to change it to a different port - e.g. 9090 - replace 8080:8080 with 9090:8080.

Once the container is launched, you can stop it and start / restart it on demand like so

$ docker stop playground
$ docker restart playground